Aktualisieren einer vorhandenen selbstverwalteten Knotengruppe - Amazon EKS

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktualisieren einer vorhandenen selbstverwalteten Knotengruppe

In diesem Thema wird beschrieben, wie Sie einen vorhandenen AWS CloudFormation selbstverwalteten Knoten-Stack mit einem neuen AMI aktualisieren können. Sie können diese Anleitung verwenden, um Ihre Knoten nach einer Cluster-Aktualisierung auf eine neue Version von Kubernetes zu aktualisieren. Andernfalls können Sie auf das neueste von Amazon EKS optimierte AMI für eine vorhandene Kubernetes-Version aktualisieren.

Wichtig

In diesem Thema werden Worker-Knotenaktualisierungen für selbstverwaltete Knotengruppen behandelt. Für weitere Informationen zur Nutzung von Verwaltete Knotengruppen siehe Aktualisieren einer verwalteten Knotengruppe.

Die neueste standardmäßige Amazon-EKS- AWS CloudFormation Knotenvorlage ist so konfiguriert, dass eine Instance mit dem neuen AMI in Ihrem Cluster gestartet wird, bevor nacheinander ein altes entfernt wird. Diese Konfiguration stellt sicher, dass Sie immer über die gewünschte Anzahl der aktiven Instances Ihre Auto-Scaling-Gruppe in Ihrem Cluster verfügen, während das Update durchgeführt wird.

Anmerkung

Diese Methode wird nicht bei Knoten-Gruppen unterstützt, die mit eksctl erstellt wurden. Wenn Sie Ihr Cluster oder Ihre Worker-Knoten-Gruppe Sie eksctl erstellt haben, finden Sie Informationen unter Migrieren zu einer neuen Worker-Knoten-Gruppe.

So aktualisieren Sie eine vorhandene Worker-Knoten-Gruppe

  1. Bestimmen Sie den DNS-Anbieter Ihres Clusters.

    kubectl get deployments -l k8s-app=kube-dns -n kube-system

    Eine Beispielausgabe sieht wie folgt aus. Dieser Cluster verwendet CoreDNS für die DNS-Auflösung, aber Ihr Cluster kann stattdessen kube-dns zurückgeben. Ihre Ausgabe kann je nach verwendeter kubectl-Version anders aussehen.

    NAME      DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
coredns   1         1         1            1           31m

  2. Wenn Ihre aktuelle Bereitstellung weniger als zwei Replikate ausführt, skalieren die Bereitstellung auf zwei Replikate. Ersetzen Sie kube-dns durch coredns, falls Ihre vorherige Befehlsausgabe dies stattdessen zurückgegeben hat.

    kubectl scale deployments/coredns --replicas=2 -n kube-system

  3. (Optional) Wenn Sie den Kubernetes Cluster Autoscaler verwenden, skalieren Sie die Bereitstellung nach unten auf null (0) Replikate, um Konflikte zwischen Skalierungsaktionen zu vermeiden.

    kubectl scale deployments/cluster-autoscaler --replicas=0 -n kube-system

  4. Bestimmen Sie den gewünschten Instance-Typ und die gewünschte Anzahl von Instances Ihrer aktuellen Worker-Knoten-Gruppe. Sie geben diese Werte später ein, wenn Sie die AWS CloudFormation Vorlage für die Gruppe aktualisieren.

    1. Öffnen Sie die Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.

    2. Wählen Sie im linken Navigationsbereich Launch Configurations (Startkonfigurationen) aus und beachten Sie den Instance-Typ für die Startkonfiguration der vorhandenen Knoten.

    3. Wählen Sie im linken Navigationsbereich Auto Scaling Groups (Auto-Scaling-Gruppen) aus und beachten Sie die Desired (gewünschte) Instance-Anzahl für die Auto-Scaling-Gruppe der vorhandenen Knoten.

  5. Öffnen Sie die - AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.

  6. Wählen Sie Ihren Workerknoten-Gruppen-Stack aus und klicken Sie dann auf Update (Aktualisieren).

  7. Wählen Sie Replace current template (Aktuelle Vorlage ersetzen) und dann Amazon S3 URL (Amazon S3-URL) aus.

  8. Fügen Sie für Amazon S3-URL die folgende URL in den Textbereich ein, um sicherzustellen, dass Sie die neueste Version der AWS CloudFormation Knotenvorlage verwenden. Klicken Sie dann auf Next (Weiter):

    https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2022-12-23/amazon-eks-nodegroup.yaml

  9. Geben Sie auf der Seite Specify stack details (Stack-Details angeben) die folgenden Parameter ein und wählen Sie Next (Weiter) aus:

    • NodeAutoScalingGroupDesiredCapacity – Geben Sie die gewünschte Instance-Anzahl ein, die Sie in einem vorherigen Schritt aufgezeichnet haben. Oder geben Sie die neue gewünschte Anzahl von Knoten ein, auf die bei der Aktualisierung Ihres Stacks skaliert werden soll.

    • NodeAutoScalingGroupMaxSize – Geben Sie die maximale Anzahl von Knoten ein, auf die Ihre Auto Scaling-Gruppe des Knotens skaliert werden kann. Dieser Wert muss mindestens einen Knoten größer sein als Ihre gewünschte Kapazität. Auf diese Weise können Sie eine fortlaufende Aktualisierung Ihrer Knoten durchführen, ohne die Knotenanzahl während der Aktualisierung zu reduzieren.

    • NodeInstanceType – Wählen Sie den Instance-Typ aus, den Sie in einem vorherigen Schritt aufgezeichnet haben. Wählen Sie alternativ einen anderen Instance-Typ für Ihre Knoten aus. Bevor Sie einen Instance-Typ auswählen, lesen Sie Auswählen eines Amazon-EC2-Instance-Typs. Jeder Amazon-EC2-Instance-Typ unterstützt eine maximale Anzahl von Elastic-Network-Interfaces (ENIs) und jedes ENI unterstützt eine maximale Anzahl von IP-Adressen. Da jedem Worker-Knoten und Pod eine eigene IP-Adresse zugewiesen wird, ist es wichtig, einen Instance-Typ auszuwählen, der die maximale Anzahl von Pods unterstützt, die auf jedem Amazon-EC2-Knoten ausgeführt werden sollen. Eine Liste der Netzwerkschnittstellen und IP-Adressen, die von Instance-Typen unterstützt werden, finden Sie unter IP-Adressen pro Netzwerkschnittstelle pro Instance-Typ. Der Instance–Typ m5.large unterstützt zum Beispiel maximal 30 IP-Adressen für den Worker-Knoten und die Pods.

      Anmerkung

      Die unterstützten Instance-Typen für die neueste Version des Amazon VPC CNI plugin for Kubernetes werden in vpc_ip_resource_limit.go auf GitHub angezeigt. Möglicherweise müssen Sie Ihre Amazon VPC CNI plugin for Kubernetes-Version aktualisieren, um die neuesten unterstützten Instance-Typen zu verwenden. Weitere Informationen finden Sie unter Arbeiten mit dem Amazon VPC CNI plugin for Kubernetes-Amazon-EKS-Add-on.

      Wichtig

      Einige Instance-Typen sind möglicherweise nicht in allen verfügbar AWS-Regionen.

    • NodeImageIdSSMParam – Der Amazon EC2 Systems Manager-Parameter der AMI-ID, auf die Sie aktualisieren möchten. Der folgende Wert verwendet das neueste Amazon-EKS-optimierte AMI für Kubernetes-Version 1.29.

      /aws/service/eks/optimized-ami/1.29/amazon-linux-2/recommended/image_id

      Sie können 1.29 mit einer unterstützten Kubernetes-Version ersetzen, die identisch ist. Oder er sollte bis zu einer Version älter sein als die Kubernetes-Version, die auf Ihrer Steuerebene läuft. Es wird empfohlen, die Knoten auf der gleichen Version wie die Steuerungsebene zu halten. Sie können auch amazon-linux-2 durch einen anderen AMI-Typ ersetzen. Weitere Informationen finden Sie unter Abrufen von Amazon-EKS-optimierten Amazon-Linux-AMI-IDs.

      Anmerkung

      Mit dem Amazon-EC2-Systems-Manager-Parameter können Sie Ihre Worker-Knoten in Zukunft aktualisieren, ohne eine AMI-ID suchen und angeben zu müssen. Wenn Ihr AWS CloudFormation -Stack diesen Wert verwendet, startet jedes Stack-Update immer das neueste empfohlene Amazon-EKS-optimierte AMI für die angegebene Kubernetes-Version. Dies ist auch dann der Fall, wenn Sie keine Werte in der Vorlage ändern.

    • NodeImageId – Um Ihr eigenes benutzerdefiniertes AMI zu verwenden, geben Sie die ID für das zu verwendende AMI ein.

      Wichtig

      Dieser Wert überschreibt jeden für NodeImageIdSSMParam angegebenen Wert. Wenn Sie den NodeImageIdSSMParam-Wert verwenden möchten, stellen Sie sicher, dass der Wert für leer NodeImageId ist.

    • DisableIMDSv1 - Standardmäßig unterstützt jeder Knoten die Instance-Metadaten-Service-Version 1 (IMDSv1) und IMDSv2. Sie können IMDSv1 jedoch deaktivieren. Wählen Sie true, wenn keine Knoten oder Pods, die in der Knotengruppe geplant sind, IMDSv1 verwenden sollen. Weitere Informationen finden Sie unter Konfiguration des Instance-Metadatenservice. Wenn Sie IAM-Rollen für Servicekonten implementiert haben, weisen Sie die erforderlichen Berechtigungen direkt allen zu, Pods die Zugriff auf AWS Services benötigen. Auf diese Weise benötigen keine Pods in Ihrem Cluster aus anderen Gründen Zugriff auf IMDS, z. B. zum Abrufen des aktuellen AWS-Region. Dann können Sie auch den Zugriff auf IMDSv2 für Pods deaktivieren, die kein Host-Netzwerk verwenden. Weitere Informationen finden Sie unter Beschränken Sie den Zugriff auf das Instance-Profil, das dem Worker-Knoten zugewiesen ist.

  10. (Optional) Markieren Sie auf der Seite Options (Optionen) Ihre Stack-Ressourcen. Wählen Sie Next (Weiter).

  11. Überprüfen Sie Ihre Angaben auf der Seite Review (Überprüfen), bestätigen Sie, dass der Stack IAM-Ressourcen erstellen kann, und klicken Sie dann auf Update stack (Stack aktualisieren).

    Anmerkung

    Die Aktualisierung jedes Knotens im Cluster dauert mehrere Minuten. Warten Sie, bis die Aktualisierung aller Knoten abgeschlossen ist, bevor Sie die nächsten Schritte durchführen.

  12. Wenn der DNS-Anbieter Ihres Clusters kube-dns ist, skalieren Sie die kube-dns-Bereitstellung auf ein Replikat.

    kubectl scale deployments/kube-dns --replicas=1 -n kube-system

  13. (Optional) Wenn Sie den Kubernetes-Cluster Autoscaler verwenden, skalieren Sie die Bereitstellung zurück auf die gewünschte Zahl von Replikaten.

    kubectl scale deployments/cluster-autoscaler --replicas=1 -n kube-system

  14. (Optional) Stellen Sie sicher, dass Sie die neueste Version des Amazon VPC CNI plugin for Kubernetes verwenden. Möglicherweise müssen Sie Ihre Amazon VPC CNI plugin for Kubernetes-Version aktualisieren, um die neuesten unterstützten Instance-Typen zu verwenden. Weitere Informationen finden Sie unter Arbeiten mit dem Amazon VPC CNI plugin for Kubernetes-Amazon-EKS-Add-on.