

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

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

 **설명** 

`AWS-UpdateEKSManagedNodeGroup` 실행서는 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을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ ClusterName

  유형: 문자열

  설명: (필수) 업데이트하려는 노드 그룹이 있는 클러스터의 이름입니다.
+ NodeGroupName

  유형: 문자열

  설명: (필수) 업데이트할 노드 그룹의 이름입니다.
+ UpdateType

  유형: 문자열

  유효한 값: Update Node Group Version \$1 Update Node Group Configurations

  기본값: Update Node Group Version

  설명: (필수) 노드 그룹에서 수행하려는 업데이트 유형입니다.

다음 파라미터는 `Version` 업데이트 유형에만 적용됩니다.
+ AMIReleaseVersion

  유형: 문자열

  설명: (선택 사항) 사용하려는 Amazon EKS 최적화 AMI 버전입니다. 기본적으로 최신 버전이 사용됩니다.
+ ForceUpgrade

  유형: Boolean

  설명: (선택 사항) true인 경우, 포드 중단 예산 위반에 대응하여 업데이트가 실패하지 않습니다.
+ 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` 파라미터에 다음 작업이 필요합니다.
+  `eks:UpdateNodegroupConfig` 
+  `eks:UpdateNodegroupVersion` 

 **문서 단계** 
+  `aws:executeScript` - 실행서 입력 파라미터에 대해 지정하는 값에 따라 Amazon EKS 클러스터 노드 그룹을 업데이트합니다.
+  `aws:waitForAwsResourceProperty` - 클러스터 업데이트 상태가 `Successful`이 될 때까지 기다립니다.