Ative o Amazon EKS Auto Mode em todos os clusters EKS usando GitHub ações

Urbija Goswami e Anugrah Lakra, da Amazon Web Services

Resumo

Os clusters do Amazon Elastic Kubernetes Service (EKS) tradicionalmente exigem gerenciamento manual de recursos computacionais por meio de grupos de nós. Isso cria uma sobrecarga operacional para:

O Amazon EKS Auto Mode automatiza o gerenciamento de recursos computacionais provisionando e escalando dinamicamente os nós com base nas demandas da carga de trabalho, eliminando a necessidade do gerenciamento manual de grupos de nós.

No entanto, muitas organizações lutam para habilitar e gerenciar consistentemente o Amazon EKS Auto Mode em seus clusters novos e existentes. Os desafios comuns incluem:

Esse padrão implementa um fluxo de trabalho de GitHub ações que ativa o modo automático do EKS em clusters do EKS em uma região específica da AWS. Antes de ativar o modo automático, o fluxo de trabalho cria backups com data e hora do estado do cluster (configuração do cluster, grupos de nós, versões do Helm e recursos personalizados) e os carrega em um bucket do Amazon S3.

Depois de ativar o Modo Automático, o fluxo de trabalho drena e exclui grupos de nós antigos, atualiza as permissões da função do cluster e limpa os componentes de escalabilidade anteriores, como Karpenter e Cluster Autoscaler. O fluxo de trabalho pode ser integrado aos pipelines existentes de integração contínua e contínua delivery/deployment (CI/CD).

Pré-requisitos e limitações

Pré-requisitos

1. Obrigatório

2. Instalação de ferramentas locais

3. Requisitos do cluster EKS

4. Requisitos de configuração do IAM OIDC

Limitações

Arquitetura

Pilha de tecnologias de destino

Arquitetura de destino

O fluxo de trabalho de GitHub ações consiste em três trabalhos principais:

Ferramentas

CLI DA AWS:

A ‭AWS Command Line Interface (AWS CLI)‭ é uma ferramenta de código aberto que ajuda na interação com os serviços da AWS por meio de comandos no seu shell de linha de comandos. Em nossa solução, usamos a interface de linha de comando dos serviços da AWS para executar atualizações de configuração de cluster EKS, atualizações de funções do IAM e consultar o status do cluster em todo o processo de automação.

Amazon EKS:

O Amazon Elastic Kubernetes Service (Amazon EKS) ajuda você a executar o Kubernetes na AWS sem precisar instalar e manter seus próprios nós ou ambiente de gerenciamento do Kubernetes. Nesse padrão, o Amazon EKS é o serviço de destino em que o Modo Automático está habilitado para automatizar o provisionamento computacional e a escalabilidade de nós entre clusters em uma região específica.

IAM:

O AWS Identity and Access Management (IAM) ajuda você a gerenciar com segurança o acesso aos seus recursos da AWS, controlando quem está autenticado e autorizado a usá-los. Em nossa solução, nós o usamos para gerenciar permissões para GitHub ações para modificar as configurações do cluster EKS por meio da federação OIDC. A solução também modifica as permissões da função de cluster e adiciona um trabalho para criar a função de nó EKS para que o EKS Auto Mode possa programar os pods pendentes em novos nós que ele cria como parte dos pools de nós.

Amazon S3:

O Amazon Simple Storage Service (Amazon S3) é um serviço de armazenamento de objetos baseado na nuvem que ajuda você a armazenar, proteger e recuperar qualquer quantidade de dados. Em nossa solução, usamos um bucket S3 para armazenar os backups com data e hora dos clusters antes que o EKS Auto Mode seja ativado neles, o que ajudaria na recuperação de desastres.

Outras ferramentas:

GitHub Ações:

GitHub Actions é uma CI/CD plataforma usada em nossa solução para automatizar o fluxo de trabalho de ativação do EKS Auto Mode. Ele também fornece autenticação segura via OIDC e gerencia a execução do pipeline em vários clusters.  

HashiCorp Terraforma:

O Terraform é uma ferramenta de infraestrutura como código (IaC) que ajuda a provisionar e gerenciar recursos e infraestrutura de nuvem por meio de código. Nossa solução usa o terraform para provisionar funções e políticas do IAM e para adicionar a configuração do provedor OIDC para integração segura GitHub de ações. 

Repositório de código

O código desse padrão está disponível no GitHub EKS Auto Mode Enablement por meio do repositório GitHub Actions.

Práticas recomendadas

Épicos

eksctl create iamidentitymapping \ --cluster $CLUSTER_NAME\ --region us-east-1 \ --arn arn:aws:iam::$ACCOUNT_ID:role/GitHubActionsEKSRole \ --group system:masters \ --username github-actions

CLUSTERS=$(aws eks list-clusters --region $AWS_REGION --query 'clusters[]' --output text)

CLUSTERS_NEEDING_AUTO_MODE=""

for cluster in $CLUSTERS; do
    
    
    AUTO_MODE=$(aws eks describe-cluster --name $cluster --region $AWS_REGION --query 'cluster.computeConfig.enabled' --output text 2>/dev/null || echo "false")
    
    if [ "$AUTO_MODE" != "True" ]; then
       
        CLUSTERS_NEEDING_AUTO_MODE="$CLUSTERS_NEEDING_AUTO_MODE $cluster"
        
        echo " Adding role access to cluster..."
        eksctl create iamidentitymapping \
          --cluster $cluster \
          --region $AWS_REGION \
          --arn $ROLE_ARN \
          --group system:masters\
          --username github-actions || echo "  ⚠️  Role mapping may already exist"
        
        echo "  ✅ Role access configured for $cluster"
done

Solução de problemas

Recursos relacionados