Aidez à améliorer cette page

Pour contribuer à ce guide de l’utilisateur, cliquez sur le lien Modifier cette page sur GitHub qui se trouve dans le volet droit de chaque page.

Création d’un cluster du mode automatique EKS à l’aide de la CLI eksctl

Cette rubrique vous explique comment créer un cluster du mode automatique Amazon EKS à l’aide de l’interface de ligne de commande (CLI) eksctl. Vous pouvez créer un cluster du mode automatique en exécutant une seule commande CLI ou en appliquant un fichier de configuration YAML. Les deux méthodes fournissent les mêmes fonctionnalités, l’approche YAML offrant un contrôle plus précis des paramètres du cluster.

La CLI eksctl simplifie le processus de création et de gestion des clusters du mode automatique EKS en gérant la création et la configuration des ressources AWS sous-jacentes. Avant de continuer, assurez-vous que les informations d’identification AWS et les autorisations nécessaires sont configurées sur votre ordinateur local. Ce guide suppose que vous connaissez les concepts de base d’Amazon EKS et que vous avez déjà installé les outils CLI requis.

Création d’un cluster du mode automatique EKS à l’aide de la commande CLI

Vous devez avoir installé les outils aws et eksctl. Vous devez être connecté à la CLI AWS avec des autorisations suffisantes pour gérer les ressources AWS, y compris : instances EC2, réseau EC2, clusters EKS et rôles IAM. Pour de plus amples informations, consultez Configuration pour utiliser Amazon EKS.

Exécutez la commande suivante pour créer un nouveau cluster du mode automatique EKS avec

eksctl create cluster --name=<cluster-name> --enable-auto-mode

Création d’un cluster du mode automatique Amazon EKS à l’aide d’un fichier YAML

Vous devez avoir installé les outils aws et eksctl. Vous devez être connecté à la CLI AWS avec des autorisations suffisantes pour gérer les ressources AWS, y compris : instances EC2, réseau EC2, clusters EKS et rôles IAM. Pour de plus amples informations, consultez Configuration pour utiliser Amazon EKS.

Passez en revue les options de configuration du mode automatique EKS dans l’exemple de ressource ClusterConfig ci-dessous. Pour la spécification complète de ClusterConfig, consultez la documentation eksctl.

AWS recommande d’activer le mode automatique EKS. Si c’est la première fois que vous créez un cluster du mode automatique EKS, laissez la valeur nodeRoleARN non spécifiée pour que le système crée un rôle IAM de nœud pour le mode automatique EKS. Si vous disposez déjà d’un rôle IAM de nœud dans votre compte AWS, AWS recommande de le réutiliser.

AWS recommande de ne pas spécifier de valeur pour nodePools. Le mode automatique EKS créera des groupes de nœuds par défaut. Vous pouvez utiliser l’API Kubernetes pour créer des groupes de nœuds supplémentaires.

# cluster.yaml
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: <cluster-name>
  region: <aws-region>

iam:
  # ARN of the Cluster IAM Role
  # optional, eksctl creates a new role if not supplied
  # suggested to use one Cluster IAM Role per account
  serviceRoleARN: <arn-cluster-iam-role>

autoModeConfig:
  # defaults to false
  enabled: boolean
  # optional, defaults to [general-purpose, system].
  # suggested to leave unspecified
  # To disable creation of nodePools, set it to the empty array ([]).
  nodePools: []string
  # optional, eksctl creates a new role if this is not supplied
  # and nodePools are present.
  nodeRoleARN: string

Enregistrez le fichier ClusterConfig sous cluster.yaml, puis utilisez la commande suivante pour créer le cluster :

eksctl create cluster -f cluster.yaml