Creazione di CNI di Amazon VPC (componente aggiuntivo di Amazon EKS) - Amazon EKS
PrerequisitiProcedura

Contribuisci a migliorare questa pagina

Per contribuire a questa guida per l’utente, seleziona il link Edit this page on GitHub che si trova nel riquadro destro di ogni pagina.

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

Utilizza i seguenti passaggi per creare il plugin CNI di Amazon VPC per il componente aggiuntivo Kubernetes di Amazon EKS.

Prima di iniziare, esamina le seguenti informazioni. Per ulteriori informazioni, consulta Considerazioni.

Prerequisiti

Di seguito sono riportati i seguenti prerequisiti per il plugin CNI di Amazon VPC per Kubernetes di Amazon EKS.

Importante

Plugin CNI di Amazon VPC per versioni Kubernetes v1.16.0 per implementare v1.16.1 versioni v1.0.0 con specifiche di CNI. Per ulteriori informazioni su v1.0.0 delle specifiche CNI, consulta Specifica dell’interfaccia di rete del container (CNI) su GitHub.

Procedura

Una volta completati i seguenti prerequisiti, segui i passaggi di seguito per creare il componente aggiuntivo.

  1. Scopri qual è la versione del componente aggiuntivo attualmente installata sul cluster.

    kubectl describe daemonset aws-node --namespace kube-system | grep amazon-k8s-cni: | cut -d : -f 3

    Di seguito viene riportato un output di esempio:

    v1.16.4-eksbuild.2

  2. Scopri qual è il tipo di componente aggiuntivo attualmente installato sul cluster. A seconda dello strumento con cui hai creato il cluster, al momento potresti non avere il componente aggiuntivo del tipo Amazon EKS installato 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

    Se è restituito il numero di versione, sul cluster è installato il componente aggiuntivo del tipo Amazon EKS e non è necessario completare i passaggi rimanenti di questa procedura. Se è restituito un errore, sul cluster non è installato il componente aggiuntivo del tipo Amazon EKS. Completa i passaggi rimanenti di questa procedura per installarlo.

  3. Salva la configurazione del componente aggiuntivo attualmente installato.

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

  4. Crea il componente aggiuntivo utilizzando AWS CLI. Se desideri utilizzare la Console di gestione AWS o il eksctl per creare il componente aggiuntivo, consulta Creare un componente aggiuntivo Amazon EKS e indica vpc-cni come nome del componente aggiuntivo. 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 tuo cluster.

    • Sostituisci v1.20.1-eksbuild.3 con la versione più recente indicata nella tabella delle versioni più recenti per la versione del cluster. Per la tabella con la versione più recente, consulta Versioni del CNI di Amazon VPC.

    • Sostituisci 111122223333 con il tuo ID account e AmazonEKSVPCCNIRole con il nome del ruolo IAM esistente creato. 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.

      aws eks create-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version v1.20.1-eksbuild.3 \
    --service-account-role-arn arn:aws:iam::111122223333:role/AmazonEKSVPCCNIRole

      Se hai applicato impostazioni personalizzate al tuo attuale componente aggiuntivo che sono in conflitto con le impostazioni predefinite del componente aggiuntivo di Amazon EKS, la creazione potrebbe non riuscire. Se la creazione non riesce, riceverai un errore che può aiutare a risolvere il problema. In alternativa, puoi aggiungere --resolve-conflicts OVERWRITE al comando precedente. Ciò consente al componente aggiuntivo di sovrascrivere le impostazioni personalizzate esistenti. Una volta creato il componente aggiuntivo, è possibile aggiornarlo con le tue impostazioni personalizzate.

  5. Verifica che la versione più recente del componente aggiuntivo per la versione del cluster sia stata aggiunta al cluster. Sostituisci my-cluster con il nome del tuo cluster.

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

    La creazione del componente aggiuntivo potrebbe richiedere alcuni secondi.

    Di seguito viene riportato un output di esempio:

    v1.20.1-eksbuild.3

  6. Se hai creato impostazioni personalizzate per il componente aggiuntivo originale, prima di creare il componente aggiuntivo di Amazon EKS, utilizza la configurazione che hai salvato precedentemente per aggiornare il componente aggiuntivo di Amazon EKS con le tue impostazioni personalizzate. Seguire la procedura riportata in Aggiornamento di CNI di Amazon VPC (componente aggiuntivo Amazon EKS).

  7. (Facoltativo) Installa cni-metrics-helper sul tuo cluster. Consente di recuperare informazioni sull'interfaccia di rete e sull'indirizzo IP, si aggrega a livello di cluster e pubblica i parametri in Amazon CloudWatch. Per ulteriori informazioni, consulta cni-metrics-helper su GitHub.