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.

# `AWS-UpdateEKSSelfManagedLinuxNodeGroups`
<a name="aws-updateeksselfmanagedlinuxnodegroup"></a>

 **Beschreibung** 

Das `AWS-UpdateEKSSelfManagedLinuxNodeGroups` Runbook aktualisiert selbstverwaltete verwaltete Knotengruppen in Ihrem Amazon Elastic Kubernetes Service (Amazon EKS) -Cluster mithilfe eines Stacks. AWS CloudFormation 

Wenn Ihr Cluster Auto Scaling verwendet, empfehlen wir, die Bereitstellung auf zwei Replikate herunterzuskalieren, bevor Sie dieses Runbook verwenden.

**Um eine Bereitstellung auf zwei Replikate zu skalieren**

1.  Installieren Sie das Kubernetes-Befehlszeilenprogramm,. `kubectl` Weitere Informationen finden Sie unter [Installieren von kubectl](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html) im *Amazon-EKS-Benutzerhandbuch*. 

1. Führen Sie den folgenden Befehl aus.

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

1. Führen Sie das Runbook aus. `AWS-UpdateEKSSelfManagedLinuxNodeGroups` 

1. Skalieren Sie die Bereitstellung wieder auf die gewünschte Anzahl von Replikaten, indem Sie den folgenden Befehl ausführen.

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

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateEKSSelfManagedLinuxNodeGroups) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Linux,macOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ ClusterName

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Name des Amazon EKS-Clusters.
+ NodeGroupName

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Name der verwalteten Knotengruppe.
+ ClusterControlPlaneSecurityGroup

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID der Sicherheitsgruppe auf der Kontrollebene.
+ Deaktivieren IMDSv1

  Typ: Boolescher Wert

  Beschreibung: (Optional) Legt fest, ob Sie den Instanz-Metadatendienst Version 1 (IMDSv1) und zulassen möchten IMDSv2.
+ KeyName

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Schlüsselname für die Instanzen.
+ NodeAutoScalingGroupDesiredCapacity

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der Knoten, die die Knotengruppe verwalten soll.
+ NodeAutoScalingGroupMaxSize

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die maximale Anzahl von Knoten, auf die die Knotengruppe skaliert werden kann.
+ NodeAutoScalingGroupMinSize

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Mindestanzahl von Knoten, auf die die Knotengruppe skaliert werden kann.
+ NodeInstanceType

  Typ: Zeichenfolge

  Standard: t3.large

  Beschreibung: (Optional) Der Instanztyp, den Sie für die Knotengruppe verwenden möchten.
+ NodeImageId

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die ID von Amazon Machine Image (AMI), die die Knotengruppe verwenden soll.
+ NodeImageIdSSMParam

  Typ: Zeichenfolge

  Standard:/aws/service/eks/optimized-ami/1.21/amazon-linux-2/recommended/image\$1id

  Beschreibung: (Optional) Der öffentliche Systems Manager Manager-Parameter für denAMI, den die Knotengruppe verwenden soll.
+ StackName

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Name des CloudFormation Stacks, der zur Aktualisierung der Knotengruppe verwendet wird.
+ Subnets

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Eine durch Kommas getrennte Liste der IDs Subnetze, die Ihr Cluster verwenden soll.
+ VpcId

  Typ: Zeichenfolge

  Standard: Standard

  Beschreibung: (Erforderlich) Die Virtual Private Cloud (VPC), in der Ihr Cluster bereitgestellt wird.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `eks:CreateCluster` 
+  `eks:CreateNodegroup` 
+  `eks:DeleteNodegroup` 
+  `eks:DeleteCluster` 
+  `eks:DescribeCluster` 
+  `eks:DescribeNodegroup` 
+  `eks:ListClusters` 
+  `eks:ListNodegroups` 
+  `eks:UpdateClusterConfig` 
+  `eks:UpdateNodegroupConfig` 

 **Dokumentschritte** 
+  `aws:executeScript`— Aktualisiert eine Amazon EKS-Cluster-Knotengruppe entsprechend den Werten, die Sie für die Runbook-Eingabeparameter angeben.
+  `aws:waitForAwsResourceProperty`- Wartet auf die Rückgabe des CloudFormation Stack-Aktualisierungsstatus.