Como soluciono problemas de modelos de lançamento personalizados com grupos de nós gerenciados no Amazon EKS?

Breve descrição

Ao usar um modelo de execução personalizado com grupos de nós gerenciados em seu cluster do Amazon EKS, você pode receber um dos seguintes erros:

• "Client.InternalError: Erro do cliente na inicialização"
• “SourceEC2LaunchTemplateNotFound ou The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x não foi encontrado”.
• “O grupo de nós entrou em um status DEGRADADO”.

Resolução

Client.InternalError: Erro do cliente na inicialização

Esse erro ocorre quando você usa volumes criptografados do Amazon Elastic Block Store (Amazon EBS) no modelo de lançamento personalizado com permissões incorretas. Para verificar o status da criptografia e as permissões ou políticas do AWS Identity and Access Management (IAM), conclua as seguintes tarefas:

• Ative a chave do AWS Key Management Service (AWS KMS) usada para criptografar o volume.
• Certifique-se de que a chave do AWS KMS tenha as políticas de chaves corretas. Para permitir que mais funções do IAM funcionem com volumes criptografados do Amazon EBS, modifique as políticas de chaves. Para obter mais informações, consulte Permitir que usuários de chaves usem a chave KMS.

SourceEc2LaunchTemplateNotFound ou TThe Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x não foi encontrada

Esse erro ocorre quando você altera manualmente a versão do modelo de lançamento personalizado por meio do grupo Auto Scaling do nó em vez do Amazon EKS. Para resolver esse problema, você deve usar o Amazon EKS para atualizar a versão do modelo de lançamento.

Para atualizar seu modelo de lançamento do EC2 a partir do grupo de nós gerenciados, conclua as seguintes etapas:

1. Abra o console do Amazon EKS.
2. No painel de navegação, escolha Clusters.
3. Em Nome do cluster, escolha o cluster que contém o grupo de nós a ser atualizado.
4. Escolha a guia Computar.
5. Para grupos de nós, escolha seu nó e, em seguida, escolha Alterar versão.
6. Selecione a versão a ser aplicada ao seu grupo de nós. Certifique-se de que a estratégia de atualização esteja definida como Atualização contínua.
7. Selecione Atualizar.

Esse erro também ocorre se você excluir um modelo de referência ao criar um grupo de nós com um modelo de lançamento personalizado. Quando você cria um grupo de nós com um modelo de lançamento personalizado, o Amazon EKS replica o modelo. Se você excluir o modelo original, deverá recriar o grupo de nós.

Para recriar o grupo de nós, conclua as seguintes etapas:

1. Inicie um novo grupo de nós.

2. Execute o comando a seguir para verificar se todos os nós estão íntegros, no estado Pronto, e se juntaram ao cluster:

   $ kubectl get nodes

3. Drene seus nós de processamento.

4. Exclua o grupo de nós original.

O grupo nós entra em um status DEGRADADO depois de criar um novo modelo de lançamento

Um grupo de nós pode entrar um estadoDEGRADADO com uma mensagem semelhante ao seguinte erro:

“O modelo de lançamento do Amazon EC2: lt-xxxxxxxxxxxxxxxx tem uma nova versão associada ao seu grupo de escalonamento automático, que não é gerenciada pelo Amazon EKS. Versão esperada do modelo de lançamento: x”.

Esse erro ocorre quando a versão do modelo de lançamento do Amazon EC2 para seu grupo de nós gerenciados não corresponde à versão criada pelo Amazon EKS. Os grupos de nós existentes que não usam um modelo de lançamento personalizado não podem ser atualizados diretamente. Para resolver esse erro, crie um modelo de lançamento e uma versão com suas configurações preferidas. Em seguida, use o modelo de lançamento para criar o grupo de nós. Se o novo grupo de nós for iniciado a partir do seu modelo personalizado, crie novas versões do modelo. Você pode usar esse modelo sem colocar o grupo de nós em um status DEGRADADO.

Informações relacionadas

Personalização de nós gerenciados com modelos de lançamento

Noções básicas sobre a configuração do modelo de lançamento