AWS-UpdateEKSManagedNodeGroup - AWS Systems Manager Referencia del manual de automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS-UpdateEKSManagedNodeGroup

Descripción

El manual de procedimientos AWS-UpdateEKSManagedNodeGroup le ayuda a actualizar un grupo de nodos administrado de Amazon Elastic Kubernetes Service (Amazon EKS). Puede elegir entre una actualización de Version o Configuration.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux, macOS, Windows

Parámetros

  • AutomationAssumeRole

    Tipo: cadena

    Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

  • ClusterName

    Tipo: cadena

    Descripción: (obligatorio) el nombre del clúster cuyo grupo de nodos desea actualizar.

  • NodeGroupName

    Tipo: cadena

    Descripción: (obligatorio) el nombre del grupo de nodos para actualizar.

  • UpdateType

    Tipo: cadena

    Valores válidos: Update Node Group Version | Update Node Group Configurations

    Predeterminado: actualizar la versión del grupo de nodos

    Descripción: (obligatorio) el tipo de actualización que desea realizar en el grupo de nodos.

Los siguientes parámetros solo se aplican al tipo de actualización Version:

  • AMI ReleaseVersion

    Tipo: cadena

    Descripción: (opcional) la versión optimizada de Amazon EKS AMI que desea utilizar. Por defecto, se utiliza la última versión.

  • ForceUpgrade

    Tipo: Booleano

    Descripción: (opcional) si es cierto, la actualización no fallará en respuesta a una infracción del presupuesto por interrupción del pod.

  • KubernetesVersion

    Tipo: cadena

    Descripción: (opcional) la versión de Kubernetes a la que actualizar el grupo de nodos.

  • LaunchTemplateId

    Tipo: cadena

    Descripción: (opcional) el ID de la plantilla de lanzamiento.

  • LaunchTemplateName

    Tipo: cadena

    Descripción: (opcional) el nombre de la plantilla de lanzamiento.

  • LaunchTemplateVersion

    Tipo: cadena

    Descripción: (opcional) la versión de la plantilla de lanzamiento de Amazon Elastic Compute Cloud (Amazon EC2). Este parámetro solo es válido si se creó un grupo de nodos a partir de una plantilla de lanzamiento.

Los siguientes parámetros solo se aplican al tipo de actualización Configuration:

  • AddOrUpdateNodeGroupLabels

    Tipo: StringMap

    Descripción: (opcional) etiquetas de Kubernetes que desea añadir o actualizar.

  • AddOrUpdateKubernetesTaintsEffect

    Tipo: StringList

    Descripción: (opcional) las taints de Kubernetes que desea añadir o actualizar.

  • MaxUnavailableNodeGroups

    Tipo: entero

    Predeterminado: 0

    Descripción: (opcional) número máximo de nodos no disponibles a la vez durante una actualización de versión.

  • MaxUnavailablePercentageNodeGroup

    Tipo: entero

    Predeterminado: 0

    Descripción: (opcional) el porcentaje de nodos que no están disponibles durante una actualización de versión.

  • NodeGroupDesiredSize

    Tipo: entero

    Predeterminado: 0

    Descripción: (opcional) cantidad actual de nodos que debería conservar el grupo de nodos administrados.

  • NodeGroupMaxSize

    Tipo: entero

    Predeterminado: 0

    Descripción: (opcional) cantidad máxima de nodos a los que puede escalar horizontalmente el grupo de nodos administrados.

  • NodeGroupMinSize

    Tipo: entero

    Predeterminado: 0

    Descripción: (opcional) cantidad mínima de nodos a los que puede reducir horizontalmente el grupo de nodos administrados.

  • RemoveKubernetesTaintsEffect

    Tipo: StringList

    Descripción: (opcional) las taints de Kubernetes que desea eliminar.

  • RemoveNodeGroupLabels

    Tipo: StringList

    Descripción: (opcional) una lista separada por comas de etiquetas que desea eliminar.

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • eks:UpdateNodegroupConfig

  • eks:UpdateNodegroupVersion

Pasos de documentos

  • aws:executeScript: actualiza un grupo de nodos de un clúster de Amazon EKS según los valores que especifique para los parámetros de entrada del manual de procedimientos.

  • aws:waitForAwsResourceProperty: espera a que el estado de actualización del clúster sea Successful.