本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

 **Description** 

 此 Runbook 會刪除與 Amazon EKS 叢集相關聯的資源，包括節點群組和 Fargate 設定檔。或者，您可以選擇刪除所有自我管理節點、用於建立節點的 CloudFormation 堆疊，以及叢集的 VPC CloudFormation 堆疊。如需刪除叢集的詳細資訊，請參閱《*Amazon EKS 使用者指南*》中的[刪除叢集](https://docs.aws.amazon.com/eks/latest/userguide/delete-cluster.html)。

**注意**  
 如果您的叢集中有與負載平衡器相關聯的作用中服務，您必須先刪除這些服務，才能刪除叢集。如果沒有，系統就無法刪除負載平衡器。執行 `AWS-DeleteEKSCluster` Runbook 之前，請使用下列程序來尋找和刪除 服務。

**在叢集中尋找和刪除服務**

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` Runbook。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteEKSCluster) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。
+ EKSClusterName

  類型：字串

  描述：（必要） 要刪除的 Amazon EKS 叢集名稱。
+ VPCCloudFormationStack

  類型：字串

  描述：（選用）要刪除之 EKS 叢集的 VPC CloudFormation 堆疊名稱。這會刪除 VPC 的 CloudFormation 堆疊和堆疊建立的任何資源。
+ VPCCloudFormationStackRole

  類型：字串

  描述：（選用） CloudFormation 擔任刪除 VPC CloudFormation 堆疊之 IAM 角色的 ARN。 CloudFormation 會使用角色的登入資料代表您進行呼叫。
+ SelfManagedNodeStacks

  類型：字串

  描述：（選用） 自我管理節點的 CloudFormation 堆疊名稱逗號分隔清單，這會刪除自我管理節點的 CloudFormation 堆疊。
+ SelfManagedNodeStacksRole

  類型：字串

  描述：（選用） CloudFormation 擔任刪除自我管理節點 Stacks 之 IAM 角色的 ARN。 CloudFormation 會使用角色的登入資料代表您進行呼叫。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+  `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 堆疊。