View a markdown version of this page

AWS-UpdateEKSManagedNodeGroup - AWS Systems Manager Riferimento al runbook dell’automazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS-UpdateEKSManagedNodeGroup

Descrizione

Il AWS-UpdateEKSManagedNodeGroup runbook ti aiuta ad aggiornare un gruppo di nodi gestiti di Amazon Elastic Kubernetes Service (Amazon EKS). Puoi sceglierne uno o aggiornarlo. Version Configuration

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

  • AutomationAssumeRole

    Tipo: String

    Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

  • ClusterName

    Tipo: String

    Descrizione: (Obbligatorio) Il nome del cluster di cui si desidera aggiornare il gruppo di nodi.

  • NodeGroupName

    Tipo: String

    Descrizione: (Obbligatorio) Il nome del gruppo di nodi da aggiornare.

  • UpdateType

    Tipo: String

    Valori validi: Update Node Group Version | Update Node Group Configurations

    Predefinito: Aggiorna la versione del gruppo di nodi

    Descrizione: (Obbligatorio) Il tipo di aggiornamento che si desidera eseguire sul gruppo di nodi.

I seguenti parametri si applicano solo al tipo di Version aggiornamento:

  • AMIReleaseVersion

    Tipo: String

    Descrizione: (Facoltativo) La versione ottimizzata di Amazon EKS AMI che desideri utilizzare. Per impostazione predefinita viene utilizzata la versione più recente.

  • ForceUpdate

    Tipo: Booleano

    Descrizione: (Facoltativo) Se vero, l'aggiornamento non fallirà in risposta a una violazione del budget relativo alle interruzioni del pod.

  • KubernetesVersion

    Tipo: String

    Descrizione: (Facoltativo) La versione di Kubernetes a cui aggiornare il gruppo di nodi.

  • LaunchTemplateId

    Tipo: String

    Descrizione: (Facoltativo) L'ID del modello di avvio.

  • LaunchTemplateName

    Tipo: String

    Descrizione: (Facoltativo) Il nome del modello di avvio.

  • LaunchTemplateVersion

    Tipo: String

    Descrizione: (Facoltativo) La versione del modello di avvio di Amazon Elastic Compute Cloud (Amazon EC2). Questo parametro è valido solo se un gruppo di nodi è stato creato da un modello di avvio.

I seguenti parametri si applicano solo al tipo di Configuration aggiornamento:

  • AddOrUpdateNodeGroupLabels

    Tipo: StringMap

    Descrizione: (Facoltativo) Etichette Kubernetes che desideri aggiungere o aggiornare.

  • AddOrUpdateKubernetesTaintsEffect

    Tipo: StringList

    Descrizione: (Facoltativo) Le contaminazioni di Kubernetes che desideri aggiungere o aggiornare.

  • MaxUnavailableNodeGroups

    Tipo: numero intero

    Impostazione predefinita: 0

    Descrizione: (Facoltativo) Il numero massimo di nodi che non sono disponibili contemporaneamente durante l'aggiornamento di una versione. Impostato su 0 (impostazione predefinita) per mantenere l'impostazione corrente.

  • MaxUnavailablePercentageNodeGroup

    Tipo: numero intero

    Impostazione predefinita: 0

    Descrizione: (Facoltativo) La percentuale di nodi che non sono disponibili durante l'aggiornamento di una versione. Impostata su 0 (impostazione predefinita) per mantenere l'impostazione corrente.

  • NodeGroupDesiredSize

    Tipo: numero intero

    Predefinito: -1

    Descrizione: (Facoltativo) Il numero di nodi che il gruppo di nodi gestito deve mantenere. Impostato su -1 (impostazione predefinita) per mantenere l'impostazione corrente.

  • NodeGroupMaxSize

    Tipo: numero intero

    Impostazione predefinita: 0

    Descrizione: (Facoltativo) Il numero massimo di nodi a cui è possibile scalare il gruppo di nodi gestiti. Impostato su 0 (impostazione predefinita) per mantenere l'impostazione corrente.

  • NodeGroupMinSize

    Tipo: numero intero

    Predefinito: -1

    Descrizione: (Facoltativo) Il numero minimo di nodi a cui è possibile scalare il gruppo di nodi gestiti. Impostato su -1 (impostazione predefinita) per mantenere l'impostazione corrente.

  • RemoveKubernetesTaintsEffect

    Tipo: StringList

    Descrizione: (Facoltativo) Le contaminazioni di Kubernetes che desideri rimuovere.

  • RemoveNodeGroupLabels

    Tipo: StringList

    Descrizione: (Facoltativo) Un elenco di etichette separate da virgole che desideri rimuovere.

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • eks:DescribeUpdate

  • eks:UpdateNodegroupConfig

  • eks:UpdateNodegroupVersion

Fasi del documento

  • aws:executeScript- Aggiorna un gruppo di nodi del cluster Amazon EKS in base ai valori specificati per i parametri di input del runbook.

  • aws:waitForAwsResourceProperty- Attende lo stato di aggiornamento del cluster. Successful