

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

 **描述** 

 此运行手册将删除与 Amazon EKS 集群关联的资源，包括节点组和 Fargate 配置文件。或者，您可以选择删除所有自管理节点、用于创建节点的 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 将使用启动此运行手册的用户的权限。
+ EKSCluster名称

  类型：字符串

  描述：（必需）要删除的 Amazon EKS 集群的名称。
+ VPCCloudFormationStack

  类型：字符串

  描述：（可选）要删除的 EKS 集群的 VPC CloudFormation 堆栈名称。这将删除 VPC 的 CloudFormation 堆栈和堆栈创建的所有资源。
+ VPCCloudFormationStackRole

  类型：字符串

  描述：（可选） CloudFormation 假定删除 VPC 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`-删除EKSCluster：删除 EKS 集群。
+  `aws:executeScript`-删除 VPCCloudFormationStack：删除 VPC CloudFormation 堆栈。