AWS-UpdateEKSManagedNodeGroup

描述

该AWS-UpdateEKSManagedNodeGroup运行手册可帮助您更新亚马逊 Elastic Kubernetes ServiceEKS（亚马逊）托管节点组。您可以选择 Version 或 Configuration 更新。

运行此自动化（控制台）

文档类型

自动化

所有者

Amazon

平台

Linux、macOS、Windows

参数

• AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems ARN Manager Automation 代表您执行操作的 AWS Identity and Access Management (IAM) 角色的亚马逊资源名称 ()。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。

• ClusterName

  类型：字符串

  描述：（必需）要更新其节点组的集群的名称。

• NodeGroupName

  类型：字符串

  描述：（必选）要更新的节点组的名称。

• UpdateType

  类型：字符串

  有效值：更新节点组版本 | 更新节点组配置

  默认：更新节点组版本

  描述：（必需）要对节点组执行的更新的类型。

以下参数仅适用于 Version 更新类型：

• AMIReleaseVersion

  类型：字符串

  描述：（可选）您要使用的Amazon EKS 优化AMI版本。默认情况下会使用最新版本。

• ForceUpgrade

  类型：布尔值

  描述：（可选）如果为真，则更新不会因容器组中断预算违规而失败。

• KubernetesVersion

  类型：字符串

  描述：（可选）要将节点组更新到的 Kubernetes 版本。

• LaunchTemplateId

  类型：字符串

  描述：（可选）启动模板的 ID。

• LaunchTemplateName

  类型：字符串

  描述：（可选）启动模板的名称。

• LaunchTemplateVersion

  类型：字符串

  描述：（可选）亚马逊弹性计算云 (AmazonEC2) 启动模板版本。此参数仅在节点组是根据启动模板创建时才有效。

以下参数仅适用于 Configuration 更新类型：

• AddOrUpdateNodeGroupLabels

  类型: StringMap

  描述：（可选）要添加或更新的 Kubernetes 标签。

• AddOrUpdateKubernetesTaintsEffect

  类型: StringList

  描述：（可选）要添加或更新的 Kubernetes 污点。

• MaxUnavailableNodeGroups

  类型：整数

  默认：0

  描述：（可选）版本更新期间一次不可用的最大节点数量。

• MaxUnavailablePercentageNodeGroup

  类型：整数

  默认值：0

  描述：（可选）版本更新期间不可用的节点的最大百分比。

• NodeGroupDesiredSize

  类型：整数

  默认值：0

  描述：（可选）托管节点组应保留的当前节点数。

• NodeGroupMaxSize

  类型：整数

  默认值：0

  描述：（可选）托管节点组可以扩展到的最大节点数。

• NodeGroupMinSize

  类型：整数

  默认值：0

  描述：（可选）托管节点组可以缩减到的最小节点数。

• RemoveKubernetesTaintsEffect

  类型: StringList

  描述：（可选）要删除的 Kubernetes 污点。

• RemoveNodeGroupLabels

  类型: StringList

  描述：（可选）要删除的以逗号分隔的标签列表。

所需IAM权限

AutomationAssumeRole 参数需要执行以下操作才能成功使用运行手册。

• eks:UpdateNodegroupConfig

• eks:UpdateNodegroupVersion

文档步骤

• aws:executeScript-根据您为 runbook 输入参数指定的值更新 Amazon EKS 集群节点组。

• aws:waitForAwsResourceProperty - 等待集群更新状态变为 Successful。