AWS-UpdateEKSManagedNodeGroup - AWS Systems Manager Referenz zum Automatisierungs-Runbook

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

Beschreibung

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

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

Linux, macOS, Windows

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der Rolle AWS Identity and Access Management (IAM), der es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzufü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: 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 von Amazon EKS optimierte Version AMI die Sie verwenden möchten. Standardmäßig wird die neueste Version verwendet.

  • ForceUpgrade

    Typ: Boolesch

    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 Startvorlagenversion von Amazon Elastic Compute Cloud (AmazonEC2). 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.

  • MaxUnavailablePercentageNodeGroup

    Typ: Ganzzahl

    Standard: 0

    Beschreibung: (Optional) Der Prozentsatz der Knoten, die während eines Versionsupdates nicht verfügbar sind.

  • NodeGroupDesiredSize

    Typ: Ganzzahl

    Standard: 0

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

  • NodeGroupMaxSize

    Typ: Ganzzahl

    Standard: 0

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

  • NodeGroupMinSize

    Typ: Ganzzahl

    Standard: 0

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

  • RemoveKubernetesTaintsEffect

    Typ: StringList

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

  • RemoveNodeGroupLabels

    Typ: StringList

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

Erforderliche Berechtigungen IAM

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • eks:UpdateNodegroupConfig

  • eks:UpdateNodegroupVersion

Dokumentschritte

  • aws:executeScript— Aktualisiert eine EKS Amazon-Cluster-Knotengruppe entsprechend den Werten, die Sie für die Runbook-Eingabeparameter angeben.

  • aws:waitForAwsResourceProperty- Wartet, bis der Cluster-Aktualisierungsstatus erreicht ist. Successful