Activez le mode automatique Amazon EKS sur les clusters EKS à l'aide d' GitHub actions

Urbija Goswami et Anugrah Lakra, Amazon Web Services

Résumé

Les clusters Amazon Elastic Kubernetes Service (EKS) nécessitent généralement une gestion manuelle des ressources de calcul via des groupes de nœuds. Cela crée une surcharge opérationnelle pour :

Amazon EKS Auto Mode automatise la gestion des ressources informatiques en provisionnant et en dimensionnant dynamiquement les nœuds en fonction des demandes de charge de travail, éliminant ainsi le besoin de gestion manuelle des groupes de nœuds.

Cependant, de nombreuses entreprises ont du mal à activer et à gérer de manière cohérente le mode automatique d'Amazon EKS sur leurs clusters existants et nouveaux. Les défis courants sont notamment les suivants :

Ce modèle implémente un flux de travail GitHub Actions qui active le mode automatique EKS sur les clusters EKS d'une région AWS spécifique. Avant d'activer le mode automatique, le flux de travail crée des sauvegardes horodatées de l'état du cluster (configuration du cluster, groupes de nœuds, versions Helm et ressources personnalisées) et les télécharge dans un compartiment Amazon S3.

Après avoir activé le mode automatique, le flux de travail vide et supprime les anciens groupes de nœuds, met à jour les autorisations relatives aux rôles du cluster et nettoie les composants de dimensionnement précédents tels que Karpenter et Cluster Autoscaler. Le flux de travail peut être intégré aux pipelines d'intégration continue et de continuous delivery/deployment (CI/CD) existants.

Conditions préalables et limitations

Conditions préalables

1. Nécessaire

2. Installation d'outils locaux

3. Exigences du cluster EKS

4. Exigences de configuration IAM OIDC

Limites

Architecture

Pile technologique cible

Architecture cible

Le flux de travail GitHub Actions comprend trois tâches principales :

Outils

CLI AWS :

L'interface de ligne de commande AWS (AWS CLI) est un outil open source qui vous permet d'interagir avec les services AWS par le biais de commandes dans votre shell de ligne de commande. Dans notre solution, nous utilisons l'interface de ligne de commande des services AWS pour exécuter les mises à jour de configuration du cluster EKS, les mises à jour des rôles IAM et demander l'état du cluster tout au long du processus d'automatisation.

Amazon EKS :

Amazon Elastic Kubernetes Service (Amazon EKS) vous aide à exécuter Kubernetes sur AWS sans avoir à installer ou à gérer votre propre plan de contrôle ou vos propres nœuds Kubernetes. Dans ce modèle, Amazon EKS est le service cible dans lequel le mode automatique est activé pour automatiser le provisionnement du calcul et le dimensionnement des nœuds sur les clusters d'une région spécifique.

IAM :

AWS Identity and Access Management (IAM) vous aide à gérer en toute sécurité l'accès à vos ressources AWS en contrôlant qui est authentifié et autorisé à les utiliser. Dans notre solution, nous l'utilisons pour gérer les autorisations relatives aux GitHub actions visant à modifier les configurations du cluster EKS via la fédération OIDC. La solution modifie également les autorisations des rôles de cluster et ajoute une tâche pour créer le rôle de nœud EKS afin que le mode automatique d'EKS puisse planifier les pods en attente dans les nouveaux nœuds qu'il lance dans le cadre des pools de nœuds.

Amazon S3 :

Amazon Simple Storage Service (Amazon S3) est un service de stockage d'objets basé sur le cloud qui vous permet de stocker, de protéger et de récupérer n'importe quel volume de données. Dans notre solution, nous utilisons un compartiment S3 pour stocker les sauvegardes horodatées des clusters avant que le mode automatique EKS ne soit activé dans ceux-ci, ce qui facilitera la reprise après sinistre.

Autres outils :

GitHub Actions :

GitHub Actions est une CI/CD plate-forme utilisée dans notre solution pour automatiser le flux de travail d'activation du mode automatique EKS. Il fournit également une authentification sécurisée via OIDC et gère l'exécution du pipeline sur plusieurs clusters.  

HashiCorp Terraforme :

Terraform est un outil d'infrastructure en tant que code (IaC) qui vous aide à utiliser le code pour provisionner et gérer l'infrastructure et les ressources du cloud. Notre solution utilise Terraform pour fournir des rôles et des politiques IAM et pour ajouter la configuration du fournisseur OIDC pour une intégration sécurisée des actions. GitHub  

Référentiel de code

Le code de ce modèle est disponible dans le référentiel GitHub EKS Auto Mode Enablement via GitHub Actions.

Bonnes pratiques

Épopées

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

Résolution des problèmes

Ressources connexes