

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

 Esse runbook exclui os atributos associados a um cluster do Amazon EKS, incluindo grupos de nós e perfis do Fargate. Opcionalmente, você pode optar por excluir todos os nós autogerenciados, as CloudFormation pilhas usadas para criar os nós e a pilha de VPC CloudFormation do seu cluster. Para obter mais informações sobre como excluir um cluster do ECS, consulte [Excluir um cluster](https://docs.aws.amazon.com/eks/latest/userguide/delete-cluster.html) no *Guia do usuário do Amazon EKS*. 

**nota**  
 Se tiver serviços ativos no cluster associados a um balanceador de carga, você deve excluir esses serviços antes de excluir o cluster. Caso contrário, o sistema não poderá excluir os balanceadores de carga. Utilizar o procedimento a seguir para localizar e excluir serviços antes de executar o runbook `AWS-DeleteEKSCluster`. 

**Para localizar e excluir serviços no cluster**

1.  Instalar o utilitário de linha de comando Kubernetes, `kubectl`. Para obter mais informações, consulte [Instalar o kubectl](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html) no *Manual do usuário do Amazon EKS*. 

1. Executar o comando a seguir para listar todos os serviços em execução no cluster.

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

1. Executar o comando a seguir para excluir todos os serviços que tenham um valor de IP EXTERNO associado. Esses serviços são liderados por um balanceador de carga e devem ser excluídos no Kubernetes para permitir que o balanceador de carga e os atributos associados sejam liberados corretamente.

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

 Agora você pode executar o runbook `AWS-DeleteEKSCluster`. 

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteEKSCluster) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ EKSClusterNome

  Tipo: string

  Descrição: (obrigatório) O nome do cluster do Amazon EKS a ser excluído.
+ VPCCloudFormationStack

  Tipo: string

  Descrição: nome da CloudFormation pilha (opcional) para VPC para o cluster EKS que está sendo excluído. Isso exclui a CloudFormation pilha da VPC e todos os recursos criados pela pilha.
+ VPCCloudFormationStackRole

  Tipo: string

  Descrição: (Opcional) O ARN de uma função do IAM que CloudFormation pressupõe a exclusão da pilha de VPC. CloudFormation CloudFormation usa as credenciais da função para fazer chamadas em seu nome.
+ SelfManagedNodeStacks

  Tipo: string

  Descrição: (Opcional) Lista separada por vírgulas de nomes de CloudFormation pilha para nós autogerenciados. Isso excluirá as CloudFormation pilhas para nós autogerenciados.
+ SelfManagedNodeStacksRole

  Tipo: string

  Descrição: (Opcional) O ARN de uma função do IAM que CloudFormation pressupõe a exclusão dos Node Stacks autogerenciados. CloudFormation usa as credenciais da função para fazer chamadas em seu nome.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `sts:AssumeRole` 
+  `eks:ListNodegroups` 
+  `eks:DeleteNodegroup` 
+  `eks:ListFargateProfiles` 
+  `eks:DeleteFargateProfile` 
+  `eks:DeleteCluster` 
+  `cfn:DescribeStacks` 
+  `cfn:DeleteStack` 

 **Etapas do documento** 
+  `aws:executeScript`- DeleteNodeGroups: Encontre e exclua todos os grupos de nós no cluster EKS. 
+  `aws:executeScript`- DeleteFargateProfiles: Encontre e exclua todos os perfis do Fargate no cluster EKS. 
+  `aws:executeScript`- DeleteSelfManagedNodes: Exclua todos os nós autogerenciados e as CloudFormation pilhas usadas para criar os nós. 
+  `aws:executeScript`- ExcluirEKSCluster: exclua o cluster EKS. 
+  `aws:executeScript`- Excluir VPCCloudFormationStack: exclua a pilha de VPC CloudFormation . 