Création d’un cluster du mode automatique Amazon EKS

Cette rubrique traite de la configuration personnalisée. Pour plus d’informations sur la configuration rapide, consultez Création d’un cluster du mode automatique EKS à l’aide de la AWS Management Console.

Cette rubrique décrit la création de clusters avec le mode automatique EKS. Pour plus d’informations sur la création de clusters sans le mode automatique EKS, consultez Création d’un cluster Amazon EKS.

Nom : nom de votre cluster. Le nom ne peut contenir que des caractères alphanumériques (sensibles à la casse), des tirets et des traits de soulignement. Il doit commencer par un caractère alphanumérique et ne peut pas dépasser 100 caractères. Le nom doit être unique dans la région AWS et le compte AWS dans lesquels vous créez le cluster.

Rôle IAM du cluster : choisissez le rôle IAM de cluster Amazon EKS que vous avez créé pour autoriser le plan de contrôle Kubernetes à gérer des ressources AWS en votre nom. Si vous n’avez pas encore créé de rôle IAM de cluster pour le mode automatique EKS, sélectionnez le bouton Créer le rôle recommandé pour créer le rôle avec les autorisations requises dans la console IAM.

Version Kubernetes : version de Kubernetes à utiliser pour votre cluster. Nous vous recommandons de sélectionner la dernière version, sauf si vous avez besoin d'une version antérieure.

Politique de mise à niveau : politique de version Kubernetes que vous souhaitez définir pour votre cluster. Si vous souhaitez que votre cluster fonctionne uniquement sur une version en prise en charge standard, choisissez Standard. Si vous souhaitez que votre cluster passe en prise en charge étendue à la fin de la période de prise en charge standard, choisissez Étendue. Si vous sélectionnez une version de Kubernetes déjà en prise en charge étendue, vous ne pouvez pas choisir la prise en charge standard comme option.

Groupes de nœuds : déterminez si vous souhaitez utiliser les groupes de nœuds intégrés. Pour de plus amples informations, consultez Activer ou désactiver les groupes de nœuds créés.

Rôle IAM de nœud : si vous activez un ou plusieurs groupes de nœuds intégrés, vous devez sélectionner un rôle IAM de nœud. Le mode automatique EKS attribuera ce rôle aux nouveaux nœuds. Vous ne pourrez plus modifier cette valeur après la création du cluster. Si vous n’avez pas encore créé de rôle IAM de nœud pour le mode automatique EKS, sélectionnez le bouton Créer le rôle recommandé pour créer le rôle avec les autorisations nécessaires. Pour plus d’informations sur ce rôle, consultez Informations sur les identités et l’accès dans le mode automatique EKS.

Amorcer l’accès administrateur au cluster : le créateur du cluster devient automatiquement administrateur Kubernetes. Si vous souhaitez désactiver cet accès automatique, sélectionnez Refuser l’accès administrateur au cluster.

Mode d’authentification du cluster : le mode automatique EKS nécessite des entrées d’accès EKS, correspondant au mode d’authentification de l’API EKS. Vous pouvez activer en option le mode d’authentification ConfigMap combiné en sélectionnant API EKS et ConfigMap.

Chiffrement des secrets : (facultatif) choisissez d'activer le chiffrement des secrets Kubernetes à l'aide d'une clé KMS. Vous pouvez également activer cette option une fois que vous avez créé votre cluster. Avant d’activer cette fonctionnalité, assurez-vous d’avoir pris connaissance des informations mentionnées dans Chiffrer les secrets Kubernetes avec KMS sur les clusters existants.

Changement de zone ARC : le mode automatique EKS ne prend pas en charge le changement de zone ARC.

Identifications∘: (facultatif) ajoutez des identifications à votre cluster. Pour de plus amples informations, consultez Organiser les ressources Amazon EKS à l’aide de balises.

Lorsque vous avez terminé d'utiliser cette page, choisissez Suivant.

VPC : choisissez un VPC existant qui répond aux exigences relatives au VPC Amazon EKS pour y créer votre cluster. Avant de sélectionner un VPC, nous vous recommandons de bien connaître toutes les exigences et considérations de Afficher les exigences réseau Amazon EKS pour les VPC et les sous-réseaux. Vous ne pouvez pas modifier le VPC que vous souhaitez utiliser après la création du cluster. Si aucun VPC n'est répertorié, vous devez d'abord en créer un. Pour de plus amples informations, consultez Création d’un VPC Amazon pour votre cluster Amazon EKS.

Sous-réseaux : par défaut, tous les sous-réseaux disponibles dans le VPC spécifié dans le champ précédent sont présélectionnés. Vous devez en sélectionner au moins deux.

Les sous-réseaux que vous choisissez doivent respecter les exigences relatives aux sous-réseaux d'Amazon EKS. Avant de sélectionner les sous-réseaux, assurez-vous de bien comprendre toutes les exigences et considérations relatives aux VPC et sous-réseaux Amazon EKS.

Groupes de sécurité : (facultatif) spécifiez un ou plusieurs groupes de sécurité créant des interfaces réseau auxquelles vous souhaitez associer Amazon EKS.

Que vous choisissiez ou non un groupe de sécurité, Amazon EKS crée un groupe de sécurité qui permet la communication entre votre cluster et votre VPC. Amazon EKS associe ce groupe de sécurité, et tout ce que vous choisissez, aux interfaces réseau qu'il crée. Pour plus d'informations sur le groupe de sécurité de cluster créé par Amazon EKS, consultez Voir les exigences relatives aux groupes de sécurité Amazon EKS pour les clusters. Vous pouvez modifier les règles dans le groupe de sécurité de cluster créé par Amazon EKS.

Choisissez la famille d'adresses IP du cluster : vous pouvez choisir entre IPv4 et IPv6.

Kubernetes attribue par défaut des adresses IPv4 aux pods et aux services. Avant de décider d’utiliser la famille IPv6, assurez-vous de bien connaître toutes les considérations et exigences mentionnées dans les rubriques Exigences et considérations relatives au VPC, Exigences et considérations requises pour les sous-réseaux, Voir les exigences relatives aux groupes de sécurité Amazon EKS pour les clusters et Informations sur les adresses IPv6 pour les clusters, pods et services. Si vous choisissez la famille IPv6, vous ne pouvez pas spécifier une plage d’adresses à partir de laquelle Kubernetes doit attribuer les adresses de service IPv6, comme c’est possible avec la famille IPv4. Kubernetes attribue les adresses de service à partir de la plage d’adresses locales uniques (fc00::/7).

(Facultatif) Choisissez Configurer la plage d'adresses IP du service Kubernetes et spécifiez une gamme de services IPv4.

La spécification de votre propre plage peut aider à prévenir les conflits entre les services Kubernetes et d’autres réseaux appairés ou connectés à votre VPC. Entrez une plage en notation CIDR. Par exemple : 10.2.0.0/16.

Le bloc d'adresse CIDR doit répondre aux critères suivants :

Pour Accès au point de terminaison de cluster, sélectionnez une option. Une fois votre cluster créé, vous pouvez modifier cette option. Avant de sélectionner une option autre que par défaut, assurez-vous de vous familiariser avec les options et leurs implications. Pour de plus amples informations, consultez Point de terminaison du serveur d’API du cluster.

Lorsque vous avez terminé d'utiliser cette page, choisissez Suivant.

Pour plus d’informations sur l’option de métriques Prometheus, consultez Étape 1 : activer les métriques Prometheus.

Pour plus d'informations sur les options de Journalisation du plan de contrôle, consultez Envoyer les journaux du plan de contrôle à CloudWatch Logs.

Lorsque vous avez terminé d'utiliser cette page, choisissez Suivant.

Le mode automatique EKS automatise les fonctionnalités de certains modules complémentaires. Si vous prévoyez de déployer des groupes de nœuds gérés par EKS sur votre cluster du mode automatique EKS, sélectionnez Modules complémentaires Amazon EKS supplémentaires et consultez les options. Vous devrez peut-être installer des modules complémentaires tels que CoreDNS et kube-proxy. EKS installera les modules complémentaires de cette section uniquement sur des nœuds et des groupes de nœuds autogérés.

Lorsque vous avez terminé d'utiliser cette page, choisissez Suivant.

Remplacez region-code par la région AWS dans laquelle vous souhaitez créer votre cluster.

Remplacez my-cluster par le nom de votre cluster. Le nom ne peut contenir que des caractères alphanumériques (sensibles à la casse), des tirets et des traits de soulignement. Il doit commencer par un caractère alphanumérique et ne peut pas dépasser 100 caractères. Le nom doit être unique dans la région AWS et le compte AWS dans lesquels vous créez le cluster.

Remplacez 1.30 par n'importe quelle version prise en charge d'Amazon EKS.

Remplacez 111122223333 par votre ID de compte

Si vous avez créé des rôles IAM nommés différemment pour les rôles de cluster et de nœud, remplacez les ARN.

Remplacez les valeurs de subnetIds par vos propres valeurs. Vous pouvez également ajouter d'autres identifiants. Vous devez spécifier au moins deux ID de sous-réseau.

Les sous-réseaux que vous choisissez doivent respecter les exigences relatives aux sous-réseaux d'Amazon EKS. Avant de sélectionner les sous-réseaux, assurez-vous de bien comprendre toutes les exigences et considérations relatives aux VPC et sous-réseaux Amazon EKS.

Si vous ne voulez pas spécifier un ID de groupe de sécurité, supprimez ,securityGroupIds=sg-<ExampleID1> depuis la commande. Si vous souhaitez spécifier un ou plusieurs ID de groupe de sécurité, remplacez les valeurs de securityGroupIds par vos propres valeurs. Vous pouvez également ajouter d'autres identifiants.

Que vous choisissiez ou non un groupe de sécurité, Amazon EKS crée un groupe de sécurité qui permet la communication entre votre cluster et votre VPC. Amazon EKS associe ce groupe de sécurité, et tout ce que vous choisissez, aux interfaces réseau qu'il crée. Pour plus d'informations sur le groupe de sécurité de cluster créé par Amazon EKS, consultez Voir les exigences relatives aux groupes de sécurité Amazon EKS pour les clusters. Vous pouvez modifier les règles dans le groupe de sécurité de cluster créé par Amazon EKS.

aws eks create-cluster \
  --region region-code \
  --name my-cluster \
  --kubernetes-version 1.30 \
  --role-arn arn:aws:iam::111122223333:role/AmazonEKSAutoClusterRole \
  --resources-vpc-config '{"subnetIds": ["subnet-ExampleID1","subnet-ExampleID2"], "securityGroupIds": ["sg-ExampleID1"], "endpointPublicAccess": true, "endpointPrivateAccess": true}' \
  --compute-config '{"enabled": true, "nodeRoleArn": "arn:aws:iam::111122223333:role/AmazonEKSAutoNodeRole", "nodePools": ["general-purpose", "system"]}' \
  --kubernetes-network-config '{"elasticLoadBalancing": {"enabled": true}}' \
  --storage-config '{"blockStorage": {"enabled": true}}' \
  --access-config '{"authenticationMode": "API"}'

Les paramètres suivants sont des paramètres facultatifs qui, si nécessaire, doivent être ajoutés à la commande précédente. Vous pouvez activer ces options uniquement lorsque vous créez le cluster, et non après.

Si vous souhaitez spécifier à partir de quel bloc de routage inter-domaines sans classe (CIDR) IPv4 Kubernetes attribue des adresses IP de service, vous devez le spécifier en ajoutant le --kubernetes-network-config serviceIpv4Cidr=<cidr-block> à la commande suivante.

La spécification de votre propre plage peut aider à prévenir les conflits entre les services Kubernetes et d’autres réseaux appairés ou connectés à votre VPC. Entrez une plage en notation CIDR. Par exemple : 10.2.0.0/16.

Le bloc d'adresse CIDR doit répondre aux critères suivants :

Si vous créez un cluster et que vous souhaitez qu’il attribue des adresses IPv6 aux pods et aux services au lieu d’adresses IPv4, ajoutez --kubernetes-network-config ipFamily=ipv6 à la commande suivante.

Kubernetes attribue par défaut des adresses IPv4 aux pods et aux services. Avant de décider d’utiliser la famille IPv6, assurez-vous de bien connaître toutes les considérations et exigences mentionnées dans les rubriques Exigences et considérations relatives au VPC, Exigences et considérations requises pour les sous-réseaux, Voir les exigences relatives aux groupes de sécurité Amazon EKS pour les clusters et Informations sur les adresses IPv6 pour les clusters, pods et services. Si vous choisissez la famille IPv6, vous ne pouvez pas spécifier une plage d’adresses à partir de laquelle Kubernetes doit attribuer les adresses de service IPv6, comme c’est possible avec la famille IPv4. Kubernetes attribue les adresses de service à partir de la plage d’adresses locales uniques (fc00::/7).