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

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

AWS-UpdateEKSSelfManagedLinuxNodeGroups

설명

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

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

배포를 복제본 2개로 조정하려면
  1. Kubernetes 명령줄 유틸리티를 설치합니다.kubectl 자세한 내용은 Amazon EKS 사용 설명서kubectl 설치를 참조하세요.

  2. 다음 명령을 실행합니다.

    kubectl scale deployments/cluster-autoscaler --replicas=2 -n kube-system
  3. AWS-UpdateEKSSelfManagedLinuxNodeGroups 실행서를 실행합니다.

  4. 다음 명령어를 실행하여 배포를 원하는 복제본 수로 다시 조정합니다.

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

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux, macOS, Windows

Parameters

  • AutomationAssumeRole

    타입: 문자열

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

  • ClusterName

    타입: 문자열

    설명: (필수) Amazon EKS 클러스터의 이름입니다.

  • NodeGroupName

    타입: 문자열

    설명: (필수) 관리형 노드 그룹의 이름입니다.

  • ClusterControlPlaneSecurityGroup

    타입: 문자열

    설명: (필수) 컨트롤 플레인 보안 그룹의 ID입니다.

  • DisableIMDSv1

    타입: 부울

    설명: (선택 사항) 인스턴스 메타데이터 서비스 버전 1(IMDSv1) 및 IMDSv2를 허용할지 결정합니다.

  • KeyName

    타입: 문자열

    설명: (선택 사항) 인스턴스의 키 이름입니다.

  • NodeAutoScalingGroupDesiredCapacity

    타입: 문자열

    설명: (선택 사항) 노드 그룹에서 유지해야 하는 노드 수입니다.

  • NodeAutoScalingGroupMaxSize

    타입: 문자열

    설명: (선택 사항) 노드 그룹이 확장될 수 있는 최대 노드 수입니다.

  • NodeAutoScalingGroupMinSize

    타입: 문자열

    설명: (선택 사항) 노드 그룹이 축소될 수 있는 최소 노드 수입니다.

  • NodeInstanceType

    타입: 문자열

    기본값: t3.large

    설명: (선택 사항) 노드 그룹에 대해 사용하려는 인스턴스 유형입니다.

  • NodeImageId

    타입: 문자열

    설명: (선택 사항) 노드 그룹에서 사용하려는 Amazon Machine Image(AMI)의 ID입니다.

  • NodeImageIdSSM 파람

    타입: 문자열

    기본값: /aws/service/eks/optimized-ami/1.21/amazon-linux-2/recommended/image_id

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

  • StackName

    타입: 문자열

    설명: (필수) 노드 그룹을 업데이트하는 데 사용되는 AWS 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- AWS CloudFormation 스택 업데이트 상태가 반환될 때까지 기다립니다.