J'utilise des scripts personnalisés, des nœuds autogérés ou des modèles de lancement personnalisés dans des Amazon Machine Images (AMI) Amazon Linux 2023 (AL2023) dans Amazon Elastic Kubernetes Service (Amazon EKS). Je souhaite fournir des données utilisateur personnalisées.
Brève description
AL2023 utilise le processus d'initialisation de nœud nodeadm qui utilise un schéma de configuration YAML. Pour les groupes de nœuds autogérés ou les groupes de nœuds gérés dotés d'un modèle de lancement personnalisé, vous devez fournir des métadonnées de cluster supplémentaires lors de création d’un nouveau groupe de nœuds. Les exigences minimales en matière de métadonnées que vous devez inclure dans le schéma de configuration YAML sont le nom du cluster, le point de terminaison du serveur API, l'autorité de certification et l'adresse CIDR du service.
Exemple de configuration avec les paramètres minimaux requis :
---
apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
cluster:
name: EKS-CLUSTER-NAME
apiServerEndpoint: API-SERVER-ENDPOINT
certificateAuthority: CERTIFICATE-AUTHORITY
cidr: SERVICE-IPv4-RANGE
Pour plus d'informations, consultez la section Avant la mise à niveau vers AL2023 dans les AMI Linux 2023 Amazon optimisées pour Amazon EKS maintenant disponibles.
Résolution
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.
Vous devez utiliser une AMI Amazon EKS qui s'exécute sur AL2023. Pour afficher l'ID de l’AMI, exécutez la commande get-parameter suivante de l'interface de ligne de commande AWS :
aws ssm get-parameter --name /aws/service/eks/optimized-ami/kubernetes-version/ami-type/recommended/image_id \
--region region-code --query "Parameter.Value" --output text
Remarque : Remplacez kubernetes-version par une version d’Amazon EKS prise en charge et region-code par votre région AWS. Remplacez également ami-type par amazon-linux-2023/x86_64/standard pour les instances x86 ou amazon-linux-2023/arm64/standard pour les instances ARM.
Ajoutez les paramètres requis minimum aux données utilisateur au format suivant :
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="BOUNDARY"
--BOUNDARY
Content-Type: application/node.eks.aws
---
apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec: ...
--BOUNDARY--
Remarque : Vous pouvez également intégrer les paramètres dans un document MIME en plusieurs parties. Pour plus d'informations, consultez la page Archive Mime en plusieurs parties sur le site Web de cloud-init.
Utilisez l'API DescribeCluster pour rechercher les ClusterDetails et afficher les paramètres minimaux requis. Par exemple, lorsque vous utilisez NodeConfigSpec, vous pouvez transmettre les options kubelet de configuration et de signalement à kubelet. Pour plus d'informations, consultez les pages CredentialProviderConfig et kubelet sur le site Web de Kubernetes.
Exemple de configuration des données utilisateur :
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="BOUNDARY"
--BOUNDARY
Content-Type: application/node.eks.aws
---
apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
cluster:
apiServerEndpoint: API_SERVER_ENDPOINT
certificateAuthority: CERTIFICATE
cidr: SERVICE_IPv4_RANGE
name: CLUSTER_NAME
kubelet:
config:
maxPods: 17
flags:
- "--node-labels=key=value"
--BOUNDARY
Content-Type: text/x-shellscript;
#!/bin/bash
set -o xtrace
yum install htop -y
--BOUNDARY--
Remarque : Lorsque vous saisissez des données utilisateur dans le modèle de lancement, veillez à ne pas inclure d'espaces ou de mises en retrait supplémentaires dans le code. Les nœuds ne peuvent pas rejoindre le cluster en cas de problème d'espacement car nodeadm ne démarre pas.