

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-UpdateEKSManagedNodeGroup`
<a name="aws-updateeksmanagednodegroup"></a>

 **Beschreibung** 

Das `AWS-UpdateEKSManagedNodeGroup` Runbook hilft Ihnen bei der Aktualisierung einer von Amazon Elastic Kubernetes Service (Amazon EKS) verwalteten Knotengruppe. Sie können entweder eine oder eine `Version` Aktualisierung auswählen. `Configuration`

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

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, 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 Clusters, dessen Knotengruppe Sie aktualisieren möchten.
+ NodeGroupName

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Der Name der Knotengruppe, die aktualisiert werden soll.
+ UpdateType

  Typ: Zeichenfolge

  Gültige Werte: Knotengruppenversion aktualisieren \| Knotengruppenkonfigurationen aktualisieren

  Standard: Version der Knotengruppe aktualisieren

  Beschreibung: (Erforderlich) Die Art des Updates, das Sie für die Knotengruppe durchführen möchten.

Die folgenden Parameter gelten nur für den `Version` Aktualisierungstyp:
+ AMIReleaseVersion

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die optimierte Version von Amazon EKSAMI, die Sie verwenden möchten. Standardmäßig wird die neueste Version verwendet.
+ ForceUpdate

  Typ: Boolescher Wert

  Beschreibung: (Optional) Wenn dieser Wert zutrifft, schlägt das Update nicht fehl, wenn das Budget bei einer Pod-Unterbrechung überschritten wurde.
+ KubernetesVersion

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Kubernetes-Version, auf die die Knotengruppe aktualisiert werden soll.
+ LaunchTemplateId

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die ID der Startvorlage.
+ LaunchTemplateName

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Name der Startvorlage.
+ LaunchTemplateVersion

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Version der Startvorlage für Amazon Elastic Compute Cloud (Amazon EC2). Dieser Parameter ist nur gültig, wenn eine Knotengruppe anhand einer Startvorlage erstellt wurde.

Die folgenden Parameter gelten nur für den `Configuration` Aktualisierungstyp:
+ AddOrUpdateNodeGroupLabels

  Typ: StringMap

  Beschreibung: (Optional) Kubernetes-Labels, die Sie hinzufügen oder aktualisieren möchten.
+ AddOrUpdateKubernetesTaintsEffect

  Typ: StringList

  Beschreibung: (Optional) Die Kubernetes-Taints, die Sie hinzufügen oder aktualisieren möchten.
+ MaxUnavailableNodeGroups

  Typ: Ganzzahl

  Standard: 0

  Beschreibung: (Optional) Die maximale Anzahl von Knoten, die während eines Versionsupdates gleichzeitig nicht verfügbar sind. Auf 0 (Standard) setzen, um die aktuelle Einstellung beizubehalten.
+ MaxUnavailablePercentageNodeGroup

  Typ: Ganzzahl

  Standard: 0

  Beschreibung: (Optional) Der Prozentsatz der Knoten, die während eines Versionsupdates nicht verfügbar sind. Auf 0 (Standard) setzen, um die aktuelle Einstellung beizubehalten.
+ NodeGroupDesiredSize

  Typ: Ganzzahl

  Standard: -1

  Beschreibung: (Optional) Die Anzahl der Knoten, die die verwaltete Knotengruppe verwalten soll. Auf -1 (Standard) setzen, um die aktuelle Einstellung beizubehalten.
+ NodeGroupMaxSize

  Typ: Ganzzahl

  Standard: 0

  Beschreibung: (Optional) Die maximale Anzahl von Knoten, auf die die verwaltete Knotengruppe skaliert werden kann. Auf 0 (Standard) setzen, um die aktuelle Einstellung beizubehalten.
+ NodeGroupMinSize

  Typ: Ganzzahl

  Standard: -1

  Beschreibung: (Optional) Die Mindestanzahl von Knoten, auf die die verwaltete Knotengruppe skaliert werden kann. Auf -1 (Standard) setzen, um die aktuelle Einstellung beizubehalten.
+ RemoveKubernetesTaintsEffect

  Typ: StringList

  Beschreibung: (Optional) Die Kubernetes-Taints, die Sie entfernen möchten.
+ RemoveNodeGroupLabels

  Typ: StringList

  Beschreibung: (Optional) Eine durch Kommas getrennte Liste von Labels, die Sie entfernen möchten.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `eks:DescribeUpdate` 
+  `eks:UpdateNodegroupConfig` 
+  `eks:UpdateNodegroupVersion` 

 **Dokumentschritte** 
+  `aws:executeScript`— Aktualisiert eine Amazon EKS-Cluster-Knotengruppe entsprechend den Werten, die Sie für die Runbook-Eingabeparameter angeben. 
+  `aws:waitForAwsResourceProperty`- Wartet, bis der Cluster-Aktualisierungsstatus erreicht ist. `Successful` 