Solucionar problemas de clusters locais do Amazon EKS no AWS Outposts

Os clusters locais são criados por meio da API do Amazon EKS, mas são executados de maneira assíncrona. Isso significa que as solicitações à API do Amazon EKS retornam imediatamente para os clusters locais. Porém, essas solicitações podem ser bem-sucedidas, antecipar-se à falha devido a erros de validação de entrada ou falhar e ter erros de validação descritivos. Esse comportamento é semelhante ao da API do Kubernetes.

Os clusters locais não fazem a transição para um status FAILED. O Amazon EKS tenta continuamente reconciliar o estado do cluster com o estado desejado solicitado pelo usuário. Como resultado, um cluster local pode permanecer no estado CREATING por um período prolongado até que o problema subjacente seja resolvido.

Problemas de cluster local podem ser descobertos usando o comando describe-cluster da AWS CLI do Amazon EKS. Problemas de cluster local são revelados pelo campo cluster.health da resposta do comando describe-cluster. A mensagem contida nesse campo inclui um código de erro, uma mensagem descritiva e IDs de recursos relacionados. Essas informações só estão disponíveis por meio da API do Amazon EKS e da AWS CLI. No exemplo a seguir, substitua my-cluster pelo nome do cluster local.

aws eks describe-cluster --name my-cluster --query 'cluster.health'

Veja um exemplo de saída abaixo.

{
    "issues": [
        {
            "code": "ConfigurationConflict",
            "message": "The instance type 'm5.large' is not supported in Outpost 'my-outpost-arn'.",
            "resourceIds": [
                "my-cluster-arn"
            ]
        }
    ]
}

Se o problema não puder ser reparado, talvez seja necessário excluir o cluster local e criar um novo. Por exemplo, tentar provisionar um cluster com um tipo de instância que não está disponível no Outpost. A tabela a seguir inclui erros comuns relacionados à integridade.

A tabela a seguir lista os erros de outros Serviços da AWS que são apresentados no campo de integridade da resposta de describe-cluster.

Os clusters locais exigem permissões e políticas diferentes das exigidas pelos clusters do Amazon EKS hospedados na nuvem. Quando a criação do cluster falhar e gera um erro InvalidPermissions, verifique novamente se o perfil do cluster que você está usando tem a política gerenciada AmazonEKSLocalOutpostClusterPolicy anexada a ele. Todas as outras chamadas de API exigem o mesmo conjunto de permissões que os clusters do Amazon EKS na nuvem.

O tempo necessário para criar um cluster local varia dependendo de vários fatores. Esses fatores incluem a configuração da rede, a configuração do Outpost e a configuração do cluster. Em geral, um cluster local é criado e passa para o status ACTIVE dentro de 15 a 20 minutos. Se um cluster local permanecer no estado CREATING, você poderá chamar describe-cluster para obter informações sobre a causa no campo de saída cluster.health.

Os problemas mais comuns são os seguintes:

A VPC e o DNS da sub-rede estão mal configurados ou falta a configuração

Consulte Criar uma VPC e sub-redes para clusters do Amazon EKS no AWS Outposts.

Quando um Outpost é desconectado da Região da AWS à qual está associado, o cluster do Kubernetes provavelmente continuará funcionando normalmente. Mas, se o cluster não funcionar corretamente, siga as etapas de solução de problemas em Preparar clusters locais do Amazon EKS no AWS Outposts para desconexões de rede. Se você encontrar outros problemas, entre em contato com o AWS Support. O AWS Support pode orientá-lo no download e na execução de uma ferramenta de coleta de logs. Assim, você poderá coletar logs das instâncias do ambiente de gerenciamento do cluster do Kubernetes e enviá-las ao AWS Support para uma investigação adicional.

Quando as instâncias do ambiente de gerenciamento do Amazon EKS não são acessíveis por meio do AWS Systems Manager (Systems Manager), o Amazon EKS exibe o erro para o cluster.

Amazon EKS control plane instances are not reachable through SSM. Please verify your SSM and network configuration, and reference the EKS on Outposts troubleshooting documentation.

Para solucionar esse problema, certifique-se de que a VPC e as sub-redes atendam aos requisitos em Criar uma VPC e sub-redes para clusters do Amazon EKS no AWS Outposts e que você concluiu as etapas em Configurar o Session Manager no Guia do usuário do AWS Systems Manager.