本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS-UpdateEKSManagedNodeGroup
Description
AWS-UpdateEKSManagedNodeGroup Runbook 可協助您更新 Amazon Elastic Kubernetes Service （Amazon EKS） 受管節點群組。您可以選擇 Version或 Configuration更新。
文件類型
自動化
擁有者
Amazon
平台
Linux、macOS, Windows
參數
-
AutomationAssumeRole
類型：字串
說明：（選用） 允許 Systems Manager Automation 代表您執行動作ARN的 （） 角色的 AWS Identity and Access Management Amazon Resource Name （IAM）。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
-
ClusterName
類型：字串
描述：（必要） 您要更新其節點群組的叢集名稱。
-
NodeGroupName
類型：字串
描述：（必要） 要更新的節點群組名稱。
-
UpdateType
類型：字串
有效值：更新節點群組版本 | 更新節點群組組態
預設：更新節點群組版本
描述：（必要） 您要在節點群組上執行的更新類型。
下列參數僅適用於Version更新類型：
-
AMIReleaseVersion
類型：字串
描述：（選用） Amazon EKS最佳化的版本 AMI 您要使用的 。根據預設會使用最新版本。
-
ForceUpgrade
類型：布林值
說明：（選用） 如果為 true，則更新不會因 Pod 中斷預算違規而失敗。
-
KubernetesVersion
類型：字串
說明：（選用） 要更新節點群組的 Kubernetes 版本。
-
LaunchTemplateId
類型：字串
描述：（選用） 啟動範本的 ID。
-
LaunchTemplateName
類型：字串
描述：（選用） 啟動範本的名稱。
-
LaunchTemplateVersion
類型：字串
說明：（選用） Amazon Elastic Compute Cloud （Amazon EC2） 啟動範本版本。此參數只有在節點群組是從啟動範本建立時才有效。
下列參數僅適用於Configuration更新類型：
-
AddOrUpdateNodeGroupLabels
類型： StringMap
說明：（選用） 您要新增或更新的 Kubernetes 標籤。
-
AddOrUpdateKubernetesTaintsEffect
類型： StringList
說明：（選用） 您要新增或更新的 Kubernetes 污點。
-
MaxUnavailableNodeGroups
類型：整數
預設：0
說明：（選用） 版本更新期間一次無法使用的節點數量上限。
-
MaxUnavailablePercentageNodeGroup
類型：整數
預設：0
說明：（選用） 版本更新期間無法使用的節點百分比。
-
NodeGroupDesiredSize
類型：整數
預設：0
描述：（選用） 受管節點群組應維護的節點數量。
-
NodeGroupMaxSize
類型：整數
預設：0
說明：（選用） 受管節點群組可以擴展到的節點數量上限。
-
NodeGroupMinSize
類型：整數
預設：0
說明：（選用） 受管節點群組可以擴展到的節點數量下限。
-
RemoveKubernetesTaintsEffect
類型： StringList
說明：（選用） 您要移除的 Kubernetes 污點。
-
RemoveNodeGroupLabels
類型： StringList
說明：（選用） 以逗號分隔的清單，列出您要移除的標籤。
必要的IAM許可
AutomationAssumeRole 參數需要下列動作才能成功使用 Runbook。
-
eks:UpdateNodegroupConfig -
eks:UpdateNodegroupVersion
文件步驟
-
aws:executeScript- 根據您為 Runbook 輸入參數指定的值更新 Amazon EKS叢集節點群組。 -
aws:waitForAwsResourceProperty- 等待叢集更新狀態為Successful。
