Creazione del EKS componente aggiuntivo Amazon VPC CNI plugin for Kubernetes Amazon

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

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

Prerequisiti

Di seguito sono riportati i prerequisiti per il EKS componente aggiuntivo Amazon VPC CNI plugin for Kubernetes Amazon.

• Un EKS cluster Amazon esistente. Per implementarne uno, consulta Inizia a usare Amazon EKS.

• Un provider AWS Identity and Access Management (IAM) OpenID Connect (OIDC) esistente per il tuo cluster. Per determinare se disponi già di un provider IAM o per crearne uno, consulta Crea un IAM OIDC provider per il tuo cluster.

• Un IAM ruolo con la policy Amazon EKS _ CNI IAM _Policy (se il cluster utilizza la IPv4 famiglia) o una IPv6policy (se il cluster utilizza la IPv6 famiglia) allegata. Per ulteriori informazioni, consulta Configura il VPC CNI plug-in Amazon da utilizzare IRSA.

• Se usi la versione 1.7.0 o successiva del Amazon VPC CNI plugin for Kubernetes e usi policy di sicurezza Pod personalizzate, consulta Eliminare la politica di EKS Pod sicurezza predefinita di AmazonComprendi le politiche di sicurezza dei pod EKS create da Amazon (PSP).

• Importante

  Amazon VPC CNI plugin for Kubernetesversioni v1.16.0 a cui è v1.16.1 stata rimossa la compatibilità con Kubernetes 1.23 le versioni precedenti. VPCCNIla versione v1.16.2 ripristina la compatibilità con Kubernetes le versioni precedenti 1.23 e CNI specifichev0.4.0.

  Amazon VPC CNI plugin for Kubernetesversioni v1.16.0 per v1.16.1 implementare la versione delle CNI specifiche. v1.0.0 CNIspec v1.0.0 è supportato nei EKS cluster che eseguono le Kubernetes versioni v1.24 o successive. VPCCNIversion v1.16.0 to v1.16.1 e CNI spec v1.0.0 non sono supportate nella Kubernetes versione v1.23 o nelle versioni precedenti. Per ulteriori informazioni sulle v1.0.0 CNI specifiche, vedere Container Network Interface (CNI) Specification su.

Procedura

Dopo aver completato i prerequisiti, effettuate le seguenti operazioni 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 tipo di EKS componente aggiuntivo Amazon installato sul tuo cluster. Replace (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

   Se viene restituito un numero di versione, nel cluster è installato il EKS tipo di componente aggiuntivo Amazon e non è necessario completare i passaggi rimanenti di questa procedura. Se viene restituito un errore, non hai il EKS tipo di componente aggiuntivo Amazon installato sul tuo cluster. 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 la AWS CLI. Se desideri utilizzare AWS Management Console o eksctl creare il componente aggiuntivo, consulta Creazione di un EKS componente aggiuntivo Amazon e specifica vpc-cni il 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 cluster.

   • Replace (Sostituisci) v1.18.3-eksbuild.2 con la versione più recente elencata nella tabella delle versioni più recenti per la versione del cluster in uso.

   • Replace (Sostituisci) 111122223333 con l'ID del tuo account e AmazonEKSVPCCNIRole con il nome di un IAMruolo esistente che hai creato. Per specificare un ruolo è necessario disporre di un provider IAM OpenID Connect (OIDC) per il cluster. Per stabilire se ne possiedi uno per il tuo cluster o per crearne uno, consulta Crea un IAM OIDC provider per il tuo cluster.

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

   Se hai applicato impostazioni personalizzate al tuo componente aggiuntivo corrente che sono in conflitto con le impostazioni predefinite del EKS componente aggiuntivo Amazon, 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, puoi aggiornarlo con le tue impostazioni personalizzate.

5. Verifica che la versione più recente del componente aggiuntivo per la versione Kubernetes del cluster sia stata aggiunta al 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
   

   La creazione del componente aggiuntivo potrebbe richiedere alcuni secondi.

   Di seguito viene riportato un output di esempio:

   v1.18.3-eksbuild.2

6. Se hai creato impostazioni personalizzate per il componente aggiuntivo originale, prima di creare il EKS componente aggiuntivo Amazon, utilizza la configurazione salvata in un passaggio precedente per aggiornare il EKS componente aggiuntivo Amazon con le tue impostazioni personalizzate.

7. (Facoltativo) Installa cni-metrics-helper sul tuo cluster. Raccoglie le informazioni sull'interfaccia di rete elastica e sull'indirizzo IP, le aggrega a livello di cluster e pubblica le metriche su Amazon. CloudWatch Per ulteriori informazioni, consulta on. cni-metrics-helper GitHub