Aktualisierung der Amazon VPC CNI (selbstverwaltetes Add-On) - Amazon EKS

Unterstützung für die Verbesserung dieser Seite beitragen

Um zu diesem Benutzerhandbuch beizutragen, klicken Sie auf den Link Diese Seite auf GitHub bearbeiten, der sich im rechten Bereich jeder Seite befindet.

Aktualisierung der Amazon VPC CNI (selbstverwaltetes Add-On)

Wichtig

Wir empfehlen, den Amazon-EKS-Typ des Add-Ons zu Ihrem Cluster hinzuzufügen, anstatt den selbstverwalteten Typ des Add-Ons zu verwenden. Wenn Sie noch keine Erfahrung mit den Unterschieden zwischen den Typen haben, finden Sie weitere Informationen unter Amazon-EKS-Add-ons. Weitere Informationen zum Hinzufügen eines Amazon-EKS-Add-ons zu Ihrem Cluster finden Sie unter Erstellung eines Amazon-EKS-Add-Ons. Wenn Sie das Amazon-EKS-Add-On nicht verwenden können, empfehlen wir Ihnen, ein Problem zu den Gründen, warum Sie es nicht verwenden können, an das GitHub-Repository Containers Roadmap zu senden.

  1. Vergewissern Sie sich, dass Sie nicht den Amazon-EKS-Typ des Add-Ons in Ihrem Cluster installiert haben. Ersetzen Sie my-cluster durch den Namen Ihres Clusters.

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

    Sollte eine Fehlermeldung angezeigt werden, ist der Amazon-EKS-Typ des Add-Ons nicht in Ihrem Cluster installiert. Um das Add-on selbst zu verwalten, führen Sie die verbleibenden Schritte in diesem Verfahren aus, um das Add-on zu aktualisieren. Wenn Sie eine Versionsnummer zurückgeben, wird der Amazon-EKS-Typ des Add-Ons auf Ihrem Cluster installiert. Verwenden Sie zum Aktualisieren das Verfahren in Aktualisierung eines Amazon-EKS-Add-Ons und nicht das Verfahren in diesem Thema. Wenn Sie mit den Unterschieden zwischen den Add-On-Typen nicht vertraut sind, finden Sie Informationen unter Amazon-EKS-Add-ons.

  2. Sehen Sie, welche Version des Container-Images derzeit auf Ihrem Cluster installiert ist.

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

    Eine Beispielausgabe sieht wie folgt aus.

    v1.20.0-eksbuild.1

    Ihre Ausgabe enthält möglicherweise nicht die Build-Nummer.

  3. Sichern Sie Ihre aktuellen Einstellungen, damit Sie dieselben Einstellungen konfigurieren können, wenn Sie Ihre Version aktualisiert haben.

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

    Um die verfügbaren Versionen zu überprüfen und sich mit den Änderungen in der Version, auf die Sie aktualisieren möchten, vertraut zu machen, sehen Sie sich die Versionen in GitHub an. Wir empfehlen die Aktualisierung auf die gleiche Version major.minor.patch, die in der Tabelle der neuesten verfügbaren Versionen aufgeführt ist, auch wenn neuere Versionen auf GitHub verfügbar sind. Die aktuellste verfügbare Versionstabelle finden Sie unter Amazon-VPC-CNI-Versionen. Die in der Tabelle aufgeführten Entwicklungsversionen sind in den auf GitHub aufgelisteten selbstverwalteten Versionen nicht angegeben. Aktualisieren Sie Ihre Version, indem Sie die Aufgaben mit einer der folgenden Optionen ausführen:

    • Wenn Sie keine benutzerdefinierten Einstellungen für das Add-On haben, führen Sie den Befehl unter der To apply this release:-Überschrift auf GitHub für die Version aus, auf die Sie aktualisieren möchten.

    • Wenn Sie benutzerdefinierte Einstellungen haben, laden Sie die Manifestdatei mit dem folgenden Befehl herunter, anstatt sie anzuwenden. Ändern Sie https://raw.githubusercontent.com/aws/amazon-vpc-cni-k8s/v1.20.0/config/master/aws-k8s-cni.yaml zu der URL für die Version auf GitHub, auf die Sie aktualisieren.

      curl -O https://raw.githubusercontent.com/aws/amazon-vpc-cni-k8s/v1.20.1/config/master/aws-k8s-cni.yaml

      Ändern Sie bei Bedarf die Datei mit den benutzerdefinierten Einstellungen aus dem von Ihnen erstellten Backup und wenden Sie die geänderte Datei dann auf Ihren Cluster an. Wenn Ihre Knoten keinen Zugriff auf die privaten Repositorys für Amazon EKS Amazon ECR haben, aus denen die Images abgerufen werden (siehe die Zeilen, die im Manifest mit image: beginnen), müssen Sie die Images herunterladen, sie in Ihr eigenes Repository kopieren und das Manifest so ändern, dass die Images aus Ihrem Repository abgerufen werden. Weitere Informationen finden Sie unter Kopieren eines Container-Images von einem Repository in ein anderes.

      kubectl apply -f aws-k8s-cni.yaml

  4. Vergewissern Sie sich, dass die neue Version jetzt auf Ihrem Cluster installiert ist.

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

    Eine Beispielausgabe sieht wie folgt aus.

    v1.20.1

  5. (Optional) Installieren Sie cni-metrics-helper in Ihrem Cluster. Es sammelt Informationen über elastische Netzwerkschnittstellen und IP-Adressen, fasst sie auf Clusterebene zusammen und veröffentlicht die Metriken in Amazon CloudWatch. Weitere Informationen finden Sie unter cni-metrics-helper auf GitHub.