

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

# `AWS-DeleteEKSCluster`
<a name="automation-aws-deleteekscluster"></a>

 **설명** 

 이 실행서는 노드 그룹 및 Fargate 프로파일을 포함하여 Amazon EKS 클러스터와 연결된 리소스를 삭제합니다. 선택적으로 모든 자체 관리형 노드, 노드를 생성하는 데 사용되는 CloudFormation 스택, 클러스터의 VPC CloudFormation 스택을 삭제하도록 선택할 수 있습니다. *클러스터 삭제에 대한 자세한 내용은 Amazon EKS 사용 설명서*의 [클러스터 삭제](https://docs.aws.amazon.com/eks/latest/userguide/delete-cluster.html)를 참조하세요.

**참고**  
 클러스터의 활성 서비스가 로드 밸런서와 연결된 경우 클러스터 삭제 전에 해당 서비스를 삭제해야 합니다. 그렇지 않으면, 시스템에서 로드 밸런서를 삭제할 수 없습니다. `AWS-DeleteEKSCluster` 실행서를 실행하기 전에 다음 절차에 따라 서비스를 찾아 삭제합니다.

**클러스터에서 서비스를 찾아 삭제하려면**

1.  Kubernetes 명령줄 유틸리티를 설치합니다.`kubectl` 자세한 내용은 *Amazon EKS 사용 설명서*의 [kubectl 설치](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)를 참조하세요.

1. 다음 명령을 실행하여 클러스터에서 실행 중인 모든 서비스를 나열합니다.

   ```
   kubectl get svc --all-namespaces
   ```

1. 다음 명령을 실행하여 연결된 EXTERNAL-IP 값이 있는 모든 서비스를 삭제합니다. 이러한 서비스는 로드 밸런서에 의해 설정되고, Kubernetes에서 이를 삭제하여 로드 밸런서와 연결된 리소스가 적절하게 릴리스되어야 합니다.

   ```
                           kubectl delete svc
                           service-name
   ```

 이제 `AWS-DeleteEKSCluster` 실행서를 실행할 수 있습니다.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteEKSCluster) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

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

  유형: 문자열

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

  유형: 문자열

  설명: 삭제 중인 EKS 클러스터의 VPC에 대한 (선택 사항) CloudFormation 스택 이름입니다. 그러면 VPC의 CloudFormation 스택과 스택에서 생성한 모든 리소스가 삭제됩니다.
+ VPCCloudFormationStackRole

  유형: 문자열

  설명: (선택 사항)가 VPC CloudFormation 스택을 삭제하도록 CloudFormation 수임하는 IAM 역할의 ARN입니다.는 역할의 자격 증명을 CloudFormation 사용하여 사용자를 대신하여 호출합니다.
+ SelfManagedNodeStacks

  유형: 문자열

  설명: (선택 사항) 자체 관리형 노드의 CloudFormation 스택 이름 목록을 쉼표로 구분하면 자체 관리형 노드의 CloudFormation 스택이 삭제됩니다.
+ SelfManagedNodeStacksRole

  유형: 문자열

  설명: (선택 사항)가 자체 관리형 노드 스택을 삭제하도록 CloudFormation 수임하는 IAM 역할의 ARN입니다.는 역할의 자격 증명을 CloudFormation 사용하여 사용자를 대신하여 호출합니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `sts:AssumeRole` 
+  `eks:ListNodegroups` 
+  `eks:DeleteNodegroup` 
+  `eks:ListFargateProfiles` 
+  `eks:DeleteFargateProfile` 
+  `eks:DeleteCluster` 
+  `cfn:DescribeStacks` 
+  `cfn:DeleteStack` 

 **문서 단계** 
+  `aws:executeScript` - DeleteNodeGroups: EKS 클러스터에서 모든 노드 그룹을 찾아 삭제합니다.
+  `aws:executeScript` - DeleteFargateProfiles: EKS 클러스터에서 모든 Fargate 프로파일을 찾아 삭제합니다.
+  `aws:executeScript` - DeleteSelfManagedNodes: 노드를 생성하는 데 사용되는 모든 자체 관리형 노드와 CloudFormation 스택을 삭제합니다.
+  `aws:executeScript` - DeleteEKSCluster: EKS 클러스터를 삭제합니다.
+  `aws:executeScript` - DeleteVPCCloudFormationStack: VPC CloudFormation 스택을 삭제합니다.