AWS-UpdateEKSSelfManagedLinuxNodeGroups - AWS Systems Manager Riferimento al runbook di 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-UpdateEKSSelfManagedLinuxNodeGroups

Descrizione

Il AWS-UpdateEKSSelfManagedLinuxNodeGroups runbook aggiorna i gruppi di nodi autogestiti nel cluster Amazon Elastic Kubernetes Service (Amazon EKS) utilizzando uno stack. AWS CloudFormation

Se il tuo cluster utilizza la scalabilità automatica, ti consigliamo di ridimensionare la distribuzione fino a due repliche prima di utilizzare questo runbook.

Per scalare una distribuzione a due repliche

  1. Installa l'utilità della riga di comando Kubernetes,. kubectl Per ulteriori informazioni, consulta la pagina relativa all'installazione di kubectl nella Guida per l'utente di Amazon EKS.

  2. Esegui il comando seguente.

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

  3. Esegui il runbook. AWS-UpdateEKSSelfManagedLinuxNodeGroups

  4. Ridimensiona la distribuzione al numero di repliche desiderato eseguendo il comando seguente.

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

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

  • AutomationAssumeRole

    Tipo: stringa

    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: stringa

    Descrizione: (Obbligatorio) Il nome del cluster Amazon EKS.

  • NodeGroupName

    Tipo: stringa

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

  • ClusterControlPlaneSecurityGroup

    Tipo: stringa

    Descrizione: (Obbligatorio) L'ID del gruppo di sicurezza del piano di controllo.

  • Disabilita IMDSv1

    Tipo: Booleano

    Descrizione: (Facoltativo) Determina se si desidera consentire Instance Metadata Service versione 1 (IMDSv1) e IMDSv2.

  • KeyName

    Tipo: stringa

    Descrizione: (Facoltativo) Il nome chiave per le istanze.

  • NodeAutoScalingGroupDesiredCapacity

    Tipo: stringa

    Descrizione: (Facoltativo) Il numero di nodi che il gruppo di nodi deve mantenere.

  • NodeAutoScalingGroupMaxSize

    Tipo: stringa

    Descrizione: (Facoltativo) Il numero massimo di nodi fino a cui il gruppo di nodi può scalare orizzontalmente.

  • NodeAutoScalingGroupMinSize

    Tipo: stringa

    Descrizione: (Facoltativo) Il numero minimo di nodi in cui il gruppo di nodi può scalare.

  • NodeInstanceType

    Tipo: stringa

    Impostazione predefinita: t3.large

    Descrizione: (Facoltativo) Il tipo di istanza che desideri utilizzare per il gruppo di nodi.

  • NodeImageId

    Tipo: stringa

    Descrizione: (Facoltativo) L'ID del Amazon Machine Image (AMI) che desiderate venga utilizzato dal gruppo di nodi.

  • NodeImageIdSSMParam

    Tipo: stringa

    Predefinito:/aws/service/eks/optimized-ami/1.21/amazon-linux-2/recommended/image_id

    Descrizione: (Facoltativo) Il parametro pubblico di Systems Manager AMI che si desidera venga utilizzato dal gruppo di nodi.

  • StackName

    Tipo: stringa

    Descrizione: (Obbligatorio) Il nome dello AWS CloudFormation stack utilizzato per aggiornare il gruppo di nodi.

  • Sottoreti

    Tipo: stringa

    Descrizione: (Obbligatorio) Un elenco separato da virgole delle IDs sottoreti che desideri vengano utilizzate dal cluster.

  • VpcId

    Tipo: stringa

    Impostazione predefinita: Default

    Descrizione: (Obbligatorio) Il cloud privato virtuale (VPC) in cui viene distribuito il cluster.

Autorizzazioni IAM richieste

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

  • eks:CreateCluster

  • eks:CreateNodegroup

  • eks:DeleteNodegroup

  • eks:DeleteCluster

  • eks:DescribeCluster

  • eks:DescribeNodegroup

  • eks:ListClusters

  • eks:ListNodegroups

  • eks:UpdateClusterConfig

  • eks:UpdateNodegroupConfig

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 che venga restituito lo stato di aggiornamento dello AWS CloudFormation stack.