AWS-UpdateEKSManagedNodeGroup

설명

AWS-UpdateEKSManagedNodeGroup런북은 아마존 Elastic Kubernetes Service EKS (Amazon) 관리형 노드 그룹을 업데이트하는 데 도움이 됩니다. Version 또는 Configuration 업데이트 중 하나를 선택할 수 있습니다.

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux, macOS, Windows

Parameters

• AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름 (). ARN 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.

• ClusterName

  유형: 문자열

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

• NodeGroupName

  유형: 문자열

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

• UpdateType

  유형: 문자열

  유효한 값: Update Node Group Version | Update Node Group Configurations

  기본값: Update Node Group Version

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

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

• AMIReleaseVersion

  유형: 문자열

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

• ForceUpgrade

  타입: 부울

  설명: (선택 사항) true인 경우, 포드 중단 예산 위반에 대응하여 업데이트가 실패하지 않습니다.

• KubernetesVersion

  유형: 문자열

  설명: (선택 사항) 노드 그룹을 업데이트할 Kubernetes 버전입니다.

• LaunchTemplateId

  유형: 문자열

  설명: (선택 사항) 시작 템플릿의 ID입니다.

• LaunchTemplateName

  유형: 문자열

  설명: (선택 사항) 시작 템플릿의 이름입니다.

• LaunchTemplateVersion

  유형: 문자열

  설명: (선택 사항) 아마존 엘라스틱 컴퓨트 클라우드 (AmazonEC2) 시작 템플릿 버전입니다. 이 파라미터는 시작 템플릿에서 노드 그룹을 생성한 경우에만 유효합니다.

다음 파라미터는 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- Runbook 입력 파라미터에 지정한 값에 따라 Amazon EKS 클러스터 노드 그룹을 업데이트합니다.

• aws:waitForAwsResourceProperty - 클러스터 업데이트 상태가 Successful이 될 때까지 기다립니다.