Comment ajouter de nouveaux sous-réseaux à un cluster Amazon EKS existant ?

Brève description

Si vous ajoutez des sous-réseaux à de nouvelles zones de disponibilité ou si vous supprimez des sous-réseaux de zones de disponibilité existantes, vous pouvez recevoir un message d'erreur similaire au suivant :

« An error occurred (InvalidParameterException) when calling the UpdateClusterConfig operation: Provided subnets belong to the AZs 'us-west-2a,us-west-2c,us-west-2d'. But they should belong to the exact set of AZs 'us-west-2a,us-west-2c' in which subnets were provided during cluster creation. »

Vos sous-réseaux doivent se trouver dans le même ensemble de zones de disponibilité qu'AWS a choisi pour vous lors de la création du cluster. Les sous-réseaux doivent également se trouver dans le même Amazon Virtual Private Cloud (Amazon VPC) que celui fourni par AWS lors de la création du cluster. Le VPC doit compter un nombre suffisant d'adresses IP disponibles pour le cluster. Pour plus d'informations, consultez les sections Créer un sous-réseau et Exigences et considérations relatives au VPC.

Résolution

Pour modifier les sous-réseaux du cluster Amazon EKS, vous pouvez utiliser la console Amazon EKS, l'AWS CLI ou l'interface de ligne de commande eksctl.

Utiliser la console Amazon EKS

Procédez comme suit :

1. Ouvrez la console Amazon EKS.
2. Dans le volet de navigation, sélectionnez Cluster.
3. Choisissez Réseau, puis sélectionnez Gérer les ressources VPC.
4. Dans le menu Sous-réseaux, sélectionnez les sous-réseaux à ajouter.
5. Sélectionnez Enregistrer.
6. Dans la section Réseau, vérifiez que les sous-réseaux ont été ajoutés.

Utiliser l’AWS CLI

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

La commande AWS CLI remplace les sous-réseaux de cluster existants par les sous-réseaux que vous incluez dans la commande. Pour ajouter des sous-réseaux, spécifiez les sous-réseaux existants et les sous-réseaux supplémentaires.

1. Exécutez la commande describe-subnets pour identifier les zones de disponibilité que vous avez configurées pour votre cluster EKS :

   aws ec2 describe-subnets --subnet-ids $(aws eks describe-cluster --name your-cluster-name --query 'cluster.resourcesVpcConfig.subnetIds' --output text) --query 'Subnets[*].AvailabilityZone'

   Remarque : Remplacez your-cluster-name par le nom de votre cluster et les exemples d'ID de sous-réseau par vos ID de sous-réseau.
   Exemple de sortie :

   [
       "us-west-2c",
       "us-west-2d",
       "us-west-2a"
   ]

2. Exécutez la commande update-cluster-config pour mettre à jour les sous-réseaux du plan de contrôle du cluster :

   aws eks update-cluster-config --name your-cluster-name \
   --resources-vpc-config subnetIds=subnet-1234,subnet-5678,subnet-9101

   Remarque : Remplacez your-cluster-name par le nom de votre cluster et les exemples d'ID de sous-réseau par vos ID de sous-réseau. Lorsque vous ajoutez de nouveaux sous-réseaux, assurez-vous de représenter chaque zone de disponibilité par rapport à la zone d'origine définie par au moins un sous-réseau. Pour conserver un sous-réseau existant pour une zone de disponibilité, incluez-le dans la commande.
   L'exemple suivant obtient les zones de disponibilité actuelles du cluster EKS et ajoute de nouveaux sous-réseaux aux zones existantes. La commande update-cluster-config inclut les sous-réseaux d'origine et les nouveaux sous-réseaux afin de conserver la configuration de la zone de disponibilité du cluster et d'étendre les sous-réseaux dans chaque zone :

   aws eks describe-cluster --name gpusharing-demo --query 'cluster.resourcesVpcConfig.subnetIds'
   [
       "subnet-03d59dfc8d9380b4c",
       "subnet-0c4f51f27d109fa32",
       "subnet-037b42db1a08da5ae"
   ]
   
   aws eks update-cluster-config --name gpusharing-demo --resources-vpc-config subnetIds=subnet-xxxxxxx80b4c,subnet-xxxxxxx8da5ae,subnet-xxxxxxx9fa32,subnet-xxxxxxee3bb,subnet-xxxxxxa761ac,subnet-xxxxxxde8b8
   {
   "update": {
   "id": "e7ed1fbf-01ab-3472-8204-149cdc3337be",
   "status": "InProgress",
   "type": "VpcConfigUpdate",
   "params": [
   {
   "type": "Subnets",
   "value": "[subnet-xxxxxxx80b4c, subnet-xxxxxxx8da5ae, subnet-xxxxxxxx9fa32, subnet-xxxxxxxee3bb, subnet-xxxxxxxxa761ac, subnet-xxxxxxde8b8]"
   }
   ],
   "createdAt": "2024-09-09T18:06:16.493000+00:00",
   "errors": []
   }
   }

Utiliser l'interface de ligne de commande eksctl

La commande CLI eksctl remplace les sous-réseaux de cluster existants par les sous-réseaux que vous incluez dans la commande. Pour ajouter des sous-réseaux, spécifiez les sous-réseaux existants et les sous-réseaux supplémentaires.

Exécutez la commande eksctl suivante pour mettre à jour les sous-réseaux du plan de contrôle du cluster :

eksctl utils update-cluster-vpc-config --cluster=your-cluster-name \
--control-plane-subnet-ids=subnet-1234,subnet-5678 --approve

L'exemple de sortie suivant montre que le cluster a été mis à jour vers un sous-réseau pour chaque zone de disponibilité :

eksctl utils update-cluster-vpc-config --cluster=gpusharing-demo  --control-plane-subnet-ids=subnet-03d59dfc8d9380b4c,subnet-0c4f51f27d109fa32,subnet-037b42db1a08da5ae --approve
2024-09-09 18:23:54 [ℹ]  using region us-west-2
2024-09-09 18:23:54 [ℹ]  will update control plane subnet IDs for cluster "gpusharing-demo" in "us-west-2" to: [subnet-xxxxxxx80b4c subnet-xxxxxxx9fa32 subnet-xxxxxx8da5ae]
2024-09-09 18:32:07 [✔]  control plane subnets and security groups for cluster "gpusharing-demo" in "us-west-2" have been updated to: controlPlaneSubnetIDs=[subnet-xxxxxxx80b4c subnet-xxxxxxxx9fa32 subnet-xxxxxxxx8da5ae], controlPlaneSecurityGroupIDs=[sg-xxxxx31d2]

Pour utiliser le fichier config.yaml afin de mettre à jour les sous-réseaux, exécutez la commande suivante :

eksctl utils update-cluster-vpc-config -f config.yaml

Exemple de sortie :

apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig
metadata:
  name: cluster
  region: us-west-2

vpc:
  controlPlaneSubnetIDs: [subnet-1234, subnet-5678, subnet-9101]
  controlPlaneSecurityGroupIDs: [sg-1234, sg-5678]

Informations connexes

Flexibilité améliorée du VPC : modifier les sous-réseaux et les groupes de sécurité dans Amazon EKS

Mise à jour des sous-réseaux et des groupes de sécurité du plan de contrôle sur le site Web d’eksctl