AWS-UpdateEKSManagedNodeGroup - AWS Systems Manager Referência do runbook de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS-UpdateEKSManagedNodeGroup

Descrição

O runbook AWS-UpdateEKSManagedNodeGroup ajuda a atualizar um grupo de nós gerenciados do Amazon Elastic Kubernetes Service (Amazon EKS). Você pode escolher uma atualização de Version ou de Configuration.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Linux, macOS, Windows

Parâmetros

  • AutomationAssumeRole

    Tipo: String

    Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

  • ClusterName

    Tipo: string

    Descrição: (obrigatório) O nome do cluster cujo grupo de nós deseja atualizar.

  • NodeGroupName

    Tipo: string

    Descrição: (obrigatório) O nome do grupo de nós a ser atualizado.

  • UpdateType

    Tipo: string

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

    Padrão: Atualizar versão do grupo de nós

    Descrição: (obrigatório) O tipo de atualização que deseja realizar no grupo de nós.

Os parâmetros a seguir se aplicam somente ao tipo de atualização de Version:

  • AMI ReleaseVersion

    Tipo: string

    Descrição: (opcional) A versão da AMI otimizada do Amazon EKS que deseja usar. A versão mais recente é usada por padrão.

  • ForceUpgrade

    Tipo: booliano

    Descrição: (opcional) Se verdadeiro, a atualização não falhará em resposta a uma violação do orçamento de interrupção do pod.

  • KubernetesVersion

    Tipo: string

    Descrição: (opcional) A versão do Kubernetes para a qual atualizar o grupo de nós.

  • LaunchTemplateId

    Tipo: string

    Descrição: (opcional) O ID do modelo de execução.

  • LaunchTemplateName

    Tipo: string

    Descrição: (opcional) O nome do modelo de execução.

  • LaunchTemplateVersion

    Tipo: string

    Descrição: (opcional) A versão do modelo de lançamento do Amazon Elastic Compute Cloud (Amazon EC2). Esse parâmetro só é válido se um grupo de nós foi criado a partir de um modelo de execução.

Os parâmetros a seguir se aplicam somente ao tipo de atualização de Configuration:

  • AddOrUpdateNodeGroupLabels

    Tipo: StringMap

    Descrição: (opcional) Rótulos do Kubernetes que deseja adicionar ou atualizar.

  • AddOrUpdateKubernetesTaintsEffect

    Tipo: StringList

    Descrição: (opcional) As taints do Kubernetes que deseja adicionar ou atualizar.

  • MaxUnavailableNodeGroups

    Tipo: número inteiro

    Padrão: 0

    Descrição: (opcional) O número máximo de nós indisponíveis ao mesmo tempo durante uma atualização de versão.

  • MaxUnavailablePercentageNodeGroup

    Tipo: número inteiro

    Padrão: 0

    Descrição: (opcional) A porcentagem de nós não disponíveis durante uma atualização de versão.

  • NodeGroupDesiredSize

    Tipo: número inteiro

    Padrão: 0

    Descrição: (opcional) O número atual de nós que o grupo de nós gerenciados deve manter.

  • NodeGroupMaxSize

    Tipo: número inteiro

    Padrão: 0

    Descrição: (opcional) O número máximo de nós para o qual o grupo de nós gerenciados pode ser aumentado na escala horizontalmente.

  • NodeGroupMinSize

    Tipo: número inteiro

    Padrão: 0

    Descrição: (opcional) O número mínimo de nós para o qual o grupo de nós gerenciados pode ser reduzido na escala horizontalmente.

  • RemoveKubernetesTaintsEffect

    Tipo: StringList

    Descrição: (opcional) As taints do Kubernetes que deseja remover.

  • RemoveNodeGroupLabels

    Tipo: StringList

    Descrição: (opcional) Uma lista separada por vírgulas dos rótulos que deseja remover.

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • eks:UpdateNodegroupConfig

  • eks:UpdateNodegroupVersion

Etapas do documento

  • aws:executeScript: atualiza um grupo de nós do cluster Amazon EKS de acordo com os valores especificados para os parâmetros de entrada do runbook.

  • aws:waitForAwsResourceProperty: espera que o status de atualização do cluster seja Successful.