Como soluciono problemas de modelos de execução 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: Client error on launch"
• "SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found"
• "Node group entered a DEGRADED status"

Resolução

Erro do cliente na execuçã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 tem 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 Permite que os usuários de chaves usem a chave do KMS.

Modelo de execução não encontrado

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

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Para atualizar seu modelo de execução do Amazon Elastic Compute Cloud (Amazon 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, selecione Clusters.
3. Em Nome do cluster, selecione o cluster que contém o grupo de nós a ser atualizado.
4. Selecione a guia Computação.
5. Em Grupos de nós, selecione seu nó e, em seguida, clique em Alterar versão.
   Observação: Você verá essa opção somente se houver uma nova revisão do modelo de execução disponível. Se não for possível ver a opção, use o comando aws eks update-nodegroup-version da AWS CLI para modificar a versão do modelo de execução do grupo de nós.
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 execução personalizado. Se você usa um modelo de execução 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 de nós entrou em um status DEGRADADO

Um grupo de nós pode entrar em um status DEGRADADO após o Amazon EKS criar um modelo de execução com uma mensagem de erro semelhante à seguinte:

"The Amazon EC2 Launch Template : lt-xxxxxxxxxxxxxxxxx has a new version associated with your Autoscaling group, which is not managed by Amazon EKS. Expected Launch Template version: x".

Esse erro ocorre quando a versão do modelo de execução do Amazon EC2 para seu grupo de nós gerenciados não corresponde à versão criada pelo Amazon EKS. Só é possível atualizar diretamente grupos de nós existentes que usam um modelo de execução personalizado. Para solucionar esse erro, crie um modelo de execução e uma versão com suas configurações preferidas. Em seguida, use o modelo de execução para criar o grupo de nós. Se o novo grupo de nós for lançado a partir do seu modelo personalizado, crie novas versões do modelo. É possível usar esse modelo sem colocar o grupo de nós em um status DEGRADADO.

Informações relacionadas

Personalizar nós gerenciados com modelos de execução

Conceitos básicos sobre a configuração do modelo de execução