Mettre à jour un EKS module complémentaire Amazon

Déterminez les modules complémentaires et les versions de modules complémentaires actuellement installés sur votre cluster. Remplacez my-cluster par le nom de votre cluster.

eksctl get addon --cluster my-cluster

L'exemple qui suit illustre un résultat.

NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0                v1.23.8-eksbuild.2
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0                v1.12.0-eksbuild.1,v1.11.4-eksbuild.1,v1.11.3-eksbuild.1,v1.11.2-eksbuild.1,v1.11.0-eksbuild.1

Votre sortie peut être différente, en fonction des modules complémentaires et des versions dont vous disposez sur votre cluster. Vous pouvez voir que dans l'exemple de sortie précédent, deux modules complémentaires existants sur le cluster disposent de versions plus récentes disponibles dans la colonne UPDATE AVAILABLE.

Mettez à jour le module complémentaire.

1. Copiez la commande qui suit sur votre appareil. Si nécessaire, apportez les modifications suivantes à la commande :

   • Remplacez my-cluster par le nom de votre cluster.

   • region-codeRemplacez-le par Région AWS celui dans lequel se trouve votre cluster.

   • Remplacez vpc-cni par le nom d'un module complémentaire renvoyé dans la sortie de l'étape précédente que vous souhaitez mettre à jour.

   • Si vous souhaitez procéder à une mise à jour vers une version antérieure à la dernière version disponible, remplacez latest par le numéro de version renvoyé dans la sortie de l'étape précédente que vous souhaitez utiliser. Certains modules complémentaires présentent des versions recommandées. Pour plus d'informations, consultez la documentation du module complémentaire que vous mettez à jour.

   • Si le module complémentaire utilise un Kubernetes compte de service et IAM rôle, 111122223333 remplacez-les par votre identifiant de compte et role-name par le nom d'un IAM rôle existant que vous avez créé. Pour obtenir des instructions sur la création d'un rôle, consultez la documentation du module complémentaire que vous créez. Pour spécifier un rôle de compte de service, vous devez disposer d'un IAM OpenID Connect (OIDC) fournisseur pour votre cluster. Pour déterminer si vous en avez un pour votre cluster ou pour en créer un, consultez Créez un IAM OIDC fournisseur pour votre cluster.

     Si le module complémentaire n'utilise pas de Kubernetes compte de service et IAM rôle, supprimez la serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name ligne.

   • L'preserveoption préserve les valeurs existantes pour le module complémentaire. Si vous avez défini des valeurs personnalisées pour les paramètres des modules complémentaires et que vous n'utilisez pas cette option, Amazon EKS remplace vos valeurs par ses valeurs par défaut. Si vous utilisez cette option, nous vous recommandons de tester les modifications de champ et de valeur sur un cluster hors production avant de mettre à jour le module complémentaire sur votre cluster de production. Si vous remplacez cette valeur paroverwrite, tous les paramètres sont remplacés par les valeurs EKS par défaut d'Amazon. Si vous avez défini des valeurs personnalisées pour des paramètres, il est possible qu'elles soient remplacées par les valeurs EKS par défaut d'Amazon. Si vous remplacez cette valeur parnone, Amazon EKS ne modifie la valeur d'aucun paramètre, mais la mise à jour risque d'échouer. Si la mise à jour échoue, vous recevez un message d'erreur pour vous aider à résoudre le conflit.

     cat >update-addon.yaml <<EOF
     apiVersion: eksctl.io/v1alpha5
     kind: ClusterConfig
     metadata:
       name: my-cluster
       region: region-code
     
     addons:
     - name: vpc-cni
       version: latest
       serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name
       resolveConflicts: preserve
     EOF
     

2. Exécutez la commande modifiée pour créer le fichier update-addon.yaml.

3. Appliquez le fichier de configuration à votre cluster.

   eksctl update addon -f update-addon.yaml
   

Pour plus d'informations sur la mise à jour des modules complémentaires, consultez la section Mise à jour des modules complémentaires dans la eksctl documentation.

Ouvrez la EKS console Amazon à l'adresse https://console.aws.amazon.com/eks/home#/clusters.

Dans le panneau de navigation de gauche, choisissez Clusters.

Choisissez le nom du cluster pour lequel vous souhaitez mettre à jour le module complémentaire.

Choisissez l'onglet Modules complémentaires.

Choisissez le module complémentaire que vous souhaitez mettre à jour.

Choisissez Modifier.

Sur le Configure name of addonpage, procédez comme suit :

1. Choisissez la version que vous souhaitez utiliser. Le module complémentaire peut présenter une version recommandée. Pour plus d'informations, consultez la documentation du module complémentaire que vous mettez à jour.

2. Pour Select IAM role, vous pouvez utiliser le IAM rôle du nœud (Non défini) ou un rôle existant que vous avez créé pour être utilisé avec le module complémentaire. S'il n'y a aucun rôle à sélectionner, vous n'avez pas de rôle existant. Quelle que soit l'option choisie, consultez la documentation du module complémentaire que vous créez pour créer une IAM politique et l'associer à un rôle. Pour sélectionner un IAM rôle, vous devez disposer d'un IAM OpenID Connect (OIDC) fournisseur pour votre cluster. Pour déterminer si vous en avez un pour votre cluster ou pour en créer un, consultez Créez un IAM OIDC fournisseur pour votre cluster.

3. Sélectionnez Paramètres de configuration facultatifs.

4. Dans Valeurs de configuration, entrez les informations de configuration spécifiques au module complémentaire. Pour plus d'informations, consultez la documentation du module complémentaire que vous mettez à jour.

5. Pour Conflict resolution method (Méthode de résolution des conflits), sélectionnez l'une des options. Si vous avez défini des valeurs personnalisées pour les paramètres des modules complémentaires, nous vous recommandons l'option Preserve (Conserver). Si vous ne choisissez pas cette option, Amazon EKS remplace vos valeurs par ses valeurs par défaut. Si vous utilisez cette option, nous vous recommandons de tester les modifications de champ et de valeur sur un cluster hors production avant de mettre à jour le module complémentaire sur votre cluster de production.

Sélectionnez Enregistrer les modifications.

Consultez la liste des modules complémentaires installés. Remplacez my-cluster par le nom de votre cluster.

aws eks list-addons --cluster-name my-cluster

L'exemple qui suit illustre un résultat.

{
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni"
    ]
}

Affichez la version actuelle du module complémentaire que vous souhaitez mettre à jour. Remplacez my-cluster par le nom de votre cluster et vpc-cni par le nom du module complémentaire que vous souhaitez mettre à jour.

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni --query "addon.addonVersion" --output text

L'exemple qui suit illustre un résultat.

v1.10.4-eksbuild.1

Déterminez les versions du module complémentaire disponibles pour la version de votre cluster. Remplacez 1.31 par la version de votre cluster et vpc-cni par le nom du module complémentaire que vous souhaitez mettre à jour.

aws eks describe-addon-versions --kubernetes-version 1.31 --addon-name vpc-cni \
    --query 'addons[].addonVersions[].{Version: addonVersion, Defaultversion: compatibilities[0].defaultVersion}' --output table

L'exemple qui suit illustre un résultat.

------------------------------------------
|          DescribeAddonVersions         |
+-----------------+----------------------+
| Defaultversion  |       Version        |
+-----------------+----------------------+
|  False          |  v1.12.0-eksbuild.1  |
|  True           |  v1.11.4-eksbuild.1  |
|  False          |  v1.10.4-eksbuild.1  |
|  False          |  v1.9.3-eksbuild.1   |
+-----------------+----------------------+

La version avec True dans la colonne Defaultversion correspond à la version avec laquelle le module complémentaire est créé, par défaut.

Mettez à jour votre module complémentaire. Copiez la commande qui suit sur votre appareil. Si nécessaire, apportez les modifications suivantes à la commande, puis exécutez la commande modifiée. Pour plus d'informations sur cette commande, consultez update-addonle manuel Amazon EKS Command Line Reference.

aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
    --service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts PRESERVE

Vérifiez l'état de la mise à jour. Remplacez my-cluster par le nom de votre cluster et vpc-cni par le nom du module complémentaire que mettez à jour.

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni

L'exemple qui suit illustre un résultat.

{
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "UPDATING",
[...]

Lorsque la mise à jour est terminé, l'état indique ACTIVE.