Aggiornamento di CNI di Amazon VPC (componente aggiuntivo Amazon EKS) - Amazon EKS

Contribuisci a migliorare questa pagina

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Per contribuire a questa guida per l'utente, scegli il GitHub link Modifica questa pagina nel riquadro destro di ogni pagina.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornamento di CNI di Amazon VPC (componente aggiuntivo Amazon EKS)

Aggiorna il tipo Amazon EKS del componente aggiuntivo del plugin CNI di Amazon VPC per Kubernetes del componente aggiuntivo Amazon EKS. Se non hai aggiunto il tipo di componente aggiuntivo Amazon EKS al cluster, è possibile installarlo seguendo Creazione di CNI di Amazon VPC (componente aggiuntivo di Amazon EKS). In alternativa, aggiorna l’altro tipo di installazione CNI di VPC seguendo Aggiornamento di CNI di Amazon VPC (componente aggiuntivo autogestito).

  1. Scopri qual è la versione del componente aggiuntivo attualmente installata sul cluster. Sostituisci my-cluster con il nome del cluster.

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

    Di seguito viene riportato un output di esempio.

    v1.20.0-eksbuild.1

    Confronta la versione con la tabella delle versioni più recenti all’indirizzo Versioni del CNI di Amazon VPC. Se la versione restituita è la stessa della versione Kubernetes del cluster presente nella tabella delle versioni più recenti, la versione più recente è già installata nel cluster e non è necessario completare il resto di questa procedura. Se nell’output ricevi un errore invece di un numero di versione, il componente aggiuntivo del tipo Amazon EKS non è installato sul cluster. È necessario creare il componente aggiuntivo prima di poterlo aggiornare con questa procedura. Per creare il tipo Amazon EKS del componente aggiuntivo CNI di VPC, segui questa pagina Creazione di CNI di Amazon VPC (componente aggiuntivo di Amazon EKS).

  2. Salva la configurazione del componente aggiuntivo attualmente installato.

    kubectl get daemonset aws-node -n kube-system -o yaml > aws-k8s-cni-old.yaml

  3. Aggiorna il tuo componente aggiuntivo utilizzando la AWS CLI. Se desideri utilizzare Console di gestione AWS o eksctl aggiornare il componente aggiuntivo, consulta. Aggiornamento di un componente aggiuntivo di Amazon EKS Copia il comando seguente sul tuo dispositivo. Apporta le seguenti modifiche al comando, se necessario, quindi esegui il comando modificato.

    • Sostituisci my-cluster con il nome del cluster.

    • v1.20.0-eksbuild.1Sostituiscilo con la versione più recente elencata nella tabella delle versioni più recenti per la versione del cluster in uso.

    • Sostituiscilo 111122223333 con l'ID del tuo account e AmazonEKSVPCCNIRole con il nome di un ruolo IAM esistente che hai creato. Per creare un ruolo IAM per CNI di VPC, consulta Passaggio 1: Creazione di un ruolo IAM per il plug-in CNI di Amazon VPC per Kubernetes. Per specificare un ruolo è necessario disporre di un gestore OpenID Connect (OIDC) IAM per il cluster. Per stabilire se ne possiedi uno per il tuo cluster o per crearne uno, consulta Per creare un provider di identità IAM OIDC per il cluster.

    • L’opzione --resolve-conflicts PRESERVE mantiene i valori di configurazione esistenti per il componente aggiuntivo. Se sono stati configurati valori personalizzati per le impostazioni del componente aggiuntivo e non si utilizza questa opzione, Amazon EKS sovrascrive i valori personalizzati con quelli predefiniti. Se utilizzi questa opzione, è preferibile testare eventuali modifiche ai campi e ai valori su un cluster non di produzione prima di aggiornare il componente aggiuntivo sul cluster di produzione. Se modifichi questo valore in OVERWRITE, tutte le impostazioni vengono modificate nei valori predefiniti di Amazon EKS. Se hai impostato valori personalizzati per un’impostazione qualsiasi, è possibile che siano sovrascritti con i valori predefiniti di Amazon EKS. Se modifichi questo valore in none, Amazon EKS non modifica il valore di alcuna impostazione, ma l’aggiornamento potrebbe non riuscire. Se l'aggiornamento non riesce, riceverai un messaggio di errore che ti aiuterà a risolvere il conflitto.

    • Se non viene aggiornata un’impostazione di configurazione, rimuovere --configuration-values '{"env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"}}' dal comando. Se stai aggiornando un'impostazione di configurazione, sostituiscila "env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"} con l'impostazione che desideri impostare. In questo esempio, la variabile di ambiente AWS_VPC_K8S_CNI_EXTERNALSNAT è impostata su true. Il valore specificato deve essere valido per lo schema di configurazione. Se non conosci lo schema di configurazioneaws eks describe-addon-configuration --addon-name vpc-cni --addon-version v1.20.0-eksbuild.1 , eseguilo sostituendolo v1.20.0-eksbuild.1 con il numero di versione del componente aggiuntivo di cui vuoi vedere la configurazione. Lo schema viene restituito nell'output. Se disponi di una configurazione personalizzata esistente, desideri rimuoverla tutta e ripristinare i valori per tutte le impostazioni ai valori predefiniti di Amazon EKS, rimuovila "env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"} dal comando, in modo che sia vuota. {} Per una spiegazione di ciascuna impostazione, consulta Variabili di configurazione CNI su. GitHub

      aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version v1.20.3-eksbuild.1 \
    --service-account-role-arn arn:aws: iam::111122223333:role/AmazonEKSVPCCNIRole \
    --resolve-conflicts PRESERVE --configuration-values '{"env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"}}'

      Il completamento dell'aggiornamento potrebbe richiedere alcuni secondi.

  4. Conferma che la versione del componente aggiuntivo sia stata aggiornata. Sostituisci my-cluster con il nome del cluster.

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

    Il completamento dell'aggiornamento potrebbe richiedere alcuni secondi.

    Di seguito viene riportato un output di esempio.

    {
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "ACTIVE",
        "addonVersion": "v1.20.3-eksbuild.1",
        "health": {
            "issues": []
        },
        "addonArn": "arn:aws: eks:region:111122223333:addon/my-cluster/vpc-cni/74c33d2f-b4dc-8718-56e7-9fdfa65d14a9",
        "createdAt": "2023-04-12T18:25:19.319000+00:00",
        "modifiedAt": "2023-04-12T18:40:28.683000+00:00",
        "serviceAccountRoleArn": "arn:aws: iam::111122223333:role/AmazonEKSVPCCNIRole",
        "tags": {},
        "configurationValues": "{\"env\":{\"AWS_VPC_K8S_CNI_EXTERNALSNAT\":\"true\"}}"
    }
}