AWS-UpdateEKSManagedNodeGroup - AWS Systems Manager 자동화 런북 참조

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

AWS-UpdateEKSManagedNodeGroup

설명

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

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux, macOS, Windows

Parameters

  • AutomationAssumeRole

    타입: 문자열

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

  • ClusterName

    타입: 문자열

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

  • NodeGroup이름

    타입: 문자열

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

  • UpdateType

    타입: 문자열

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

    기본값: Update Node Group Version

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

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

  • AMI ReleaseVersion

    타입: 문자열

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

  • ForceUpgrade

    타입: 부울

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

  • KubernetesVersion

    타입: 문자열

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

  • LaunchTemplate아이디

    타입: 문자열

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

  • LaunchTemplate이름

    타입: 문자열

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

  • LaunchTemplate버전

    타입: 문자열

    설명: (선택 사항) Amazon Elastic Compute Cloud(Amazon EC2) 시작 템플릿 버전입니다. 이 파라미터는 시작 템플릿에서 노드 그룹을 생성한 경우에만 유효합니다.

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

  • AddOrUpdateNodeGroupLabels

    유형: StringMap

    설명: (선택 사항) 추가하거나 업데이트하려는 Kubernetes 레이블입니다.

  • AddOrUpdateKubernetesTaintsEffect

    유형: StringList

    설명: (선택 사항) 추가하거나 업데이트하려는 Kubernetes 테인트입니다.

  • MaxUnavailableNodeGroups

    유형: 정수

    기본값: 0

    설명: (선택 사항) 버전 업데이트 중 한 번에 사용할 수 없는 최대 노드 수입니다.

  • MaxUnavailablePercentageNode그룹

    유형: 정수

    기본값: 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이 될 때까지 기다립니다.