View a markdown version of this page

AWS-UpdateEKSSelfManagedLinuxNodeGroups - 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-UpdateEKSSelfManagedLinuxNodeGroups

Descrizione

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

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

Per scalare una distribuzione fino a due repliche

  1. Installa l'utilità a 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. Eseguire il seguente comando seguente.

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

  3. Esegui il runbook. AWS-UpdateEKSSelfManagedLinuxNodeGroups

  4. Ridimensiona la distribuzione al numero desiderato di repliche 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: 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 Amazon EKS.

  • NodeGroupName

    Tipo: String

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

  • ClusterControlPlaneSecurityGroup

    Tipo: String

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

  • Disattiva IMDSv1

    Tipo: Booleano

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

  • KeyName

    Tipo: String

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

  • NodeAutoScalingGroupDesiredCapacity

    Tipo: String

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

  • NodeAutoScalingGroupMaxSize

    Tipo: String

    Descrizione: (Facoltativo) Il numero massimo di nodi a cui è possibile scalare il gruppo di nodi.

  • NodeAutoScalingGroupMinSize

    Tipo: String

    Descrizione: (Facoltativo) Il numero minimo di nodi a cui è possibile scalare il gruppo di nodi.

  • NodeInstanceType

    Tipo: String

    Predefinito: t3.large

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

  • NodeImageId

    Tipo: String

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

  • NodeImageIdSSMParam

    Tipo: String

    Predefinito:/aws/service/eks/optimized-ami/1. 21/amazon-linux- /image_id 2/recommended

    Descrizione: (Facoltativo) Il parametro pubblico di Systems Manager per il quale si desidera AMI che il gruppo di nodi utilizzi.

  • StackName

    Tipo: String

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

  • Sottoreti

    Tipo: String

    Descrizione: (Obbligatorio) Un elenco separato da virgole degli ID per le sottoreti che desideri che il cluster utilizzi.

  • VpcId

    Tipo: String

    Impostazione predefinita: Default

    Descrizione: (Obbligatorio) Il cloud privato virtuale (VPC) in cui è 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 CloudFormation stack.