기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

 **설명** 

`AWS-UpdateEKSSelfManagedLinuxNodeGroups` 실행서는 AWS CloudFormation 스택을 사용하여 Amazon Elastic Kubernetes Service(Amazon EKS) 클러스터의 자체 관리 관리형 노드 그룹을 업데이트합니다.

클러스터에서 Auto Scaling을 사용하는 경우 이 실행서를 사용하기 전에 배포를 복제본 2개로 조정하는 것이 좋습니다.

**배포를 복제본 2개로 조정하려면**

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입니다.
+ DisableIMDSv1

  유형: Boolean

  설명: (선택 사항) 인스턴스 메타데이터 서비스 버전 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\_id

  설명: (선택 사항) 노드 그룹에서 사용하려는 AMI에 대한 공용 Systems Manager 파라미터입니다.
+ StackName

  유형: 문자열

  설명: (필수) 노드 그룹을 업데이트하는 데 사용되는 CloudFormation 스택의 이름입니다.
+ 서브넷

  유형: 문자열

  설명: (필수) 클러스터에서 사용하려는 서브넷의 쉼표로 구분된 목록입니다.
+ VpcId

  유형: 문자열

  기본값: Default

  설명: (필수) 클러스터가 배포된 Virtual Private Cloud(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 스택 업데이트 상태가 반환될 때까지 기다립니다.