本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `AWS-UpdateEKSManagedNodeGroup`
<a name="aws-updateeksmanagednodegroup"></a>

 **Description** 

`AWS-UpdateEKSManagedNodeGroup` Runbook 可協助您更新 Amazon Elastic Kubernetes Service (Amazon EKS) 受管節點群組。您可以選擇 `Version`或 `Configuration`更新。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateEKSManagedNodeGroup) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。
+ ClusterName

  類型：字串

  描述：（必要） 您要更新其節點群組的叢集名稱。
+ NodeGroupName

  類型：字串

  描述：（必要） 要更新的節點群組名稱。
+ UpdateType

  類型：字串

  有效值：更新節點群組版本 \$1 更新節點群組組態

  預設：更新節點群組版本

  描述：（必要） 您要在節點群組上執行的更新類型。

下列參數僅適用於`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`。