本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `AWS-UpdateEKSSelfManagedLinuxNodeGroups`
<a name="aws-updateeksselfmanagedlinuxnodegroup"></a>

 **描述** 

`AWS-UpdateEKSSelfManagedLinuxNodeGroups` 运行手册使用 AWS CloudFormation 堆栈更新 Amazon Elastic Kubernetes Service (Amazon EKS) 集群中的自托管节点组。

如果您的集群使用自动扩缩，则我们建议在使用此运行手册之前将部署缩小到两个副本。

**将部署扩展到两个副本**

1.  安装 Kubernetes 命令行实用程序 `kubectl`。有关更多信息，请参阅 *Amazon EKS 用户指南* 中的[安装 kubectl](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)。

1. 运行如下命令。

   ```
   kubectl scale deployments/cluster-autoscaler --replicas=2 -n kube-system
   ```

1. 运行 `AWS-UpdateEKSSelfManagedLinuxNodeGroups` 运行手册。

1. 运行以下命令，将部署缩回到所需的副本数。

   ```
   kubectl scale deployments/cluster-autoscaler --replicas=number -n kube-system
   ```

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateEKSSelfManagedLinuxNodeGroups) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux、macOS、Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

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

  类型：字符串

  描述：（必需）Amazon EKS 集群的名称。
+ NodeGroupName

  类型：字符串

  描述：（必需）托管节点组的名称。
+ ClusterControlPlaneSecurityGroup

  类型：字符串

  描述：（必需）控制面板安全组的 ID。
+ 禁用 IMDSv1

  类型：布尔值

  描述：（可选）确定是否要允许实例元数据服务版本 1 (IMDSv1) 和 IMDSv2。
+ KeyName

  类型：字符串

  描述：（可选）实例的秘钥名称。
+ NodeAutoScalingGroupDesiredCapacity

  类型：字符串

  描述：（可选）节点组应保留的节点数。
+ NodeAutoScalingGroupMaxSize

  类型：字符串

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

  类型：字符串

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

  类型：字符串

  默认：t3.large

  描述：（可选）要用于节点组的实例类型。
+ NodeImageId

  类型：字符串

  描述：（可选）希望节点组使用的 Amazon Machine Image (AMI) 的 ID。
+ NodeImageIdSSMParam

  类型：字符串

  默认值：/aws/service/eks/optimized-ami/1.21/amazon-linux-2/recommended/image\$1id

  描述：（可选）希望节点组使用的 AMI 的公共 Systems Manager 参数。
+ StackName

  类型：字符串

  描述：（必填）用于更新节点组的 CloudFormation 堆栈的名称。
+ 子网

  类型：字符串

  描述：（必填）以逗号分隔的列表，列 IDs 出您希望您的集群使用的子网。
+ VpcId

  类型：字符串

  默认：Default

  描述：（必需）部署集群的虚拟私有云（VPC）。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `eks:CreateCluster` 
+  `eks:CreateNodegroup` 
+  `eks:DeleteNodegroup` 
+  `eks:DeleteCluster` 
+  `eks:DescribeCluster` 
+  `eks:DescribeNodegroup` 
+  `eks:ListClusters` 
+  `eks:ListNodegroups` 
+  `eks:UpdateClusterConfig` 
+  `eks:UpdateNodegroupConfig` 

 **文档步骤** 
+  `aws:executeScript` - 根据您为运行手册输入参数指定的值更新 Amazon EKS 集群节点组。
+  `aws:waitForAwsResourceProperty`-等待 CloudFormation 堆栈更新状态返回。