

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, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. 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: Knotengruppenversion aktualisieren

  Beschreibung: (Erforderlich) Die Art der Aktualisierung, die 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 der Wert „true“ ist, schlägt das Update nicht fehl, wenn das Budget aufgrund einer Unterbrechung des Pod-Budgets überschritten wird.
+ KubernetesVersion

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Kubernetes-Version, auf die die Node-Gruppe 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 Amazon Elastic Compute Cloud (Amazon EC2) -Startvorlage. Dieser Parameter ist nur gültig, wenn eine Knotengruppe aus 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. Setzen Sie den Wert auf 0 (Standard), 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-Flecken, 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-Clusterknotengruppe gemäß den Werten, die Sie für die Runbook-Eingabeparameter angeben. 
+  `aws:waitForAwsResourceProperty`— Wartet darauf, dass der Cluster-Aktualisierungsstatus lautet. `Successful` 