**Ajudar a melhorar esta página** 

Para contribuir com este guia de usuário, escolha o link **Editar esta página no GitHub**, disponível no painel direito de cada página.

# Habilitar o Modo Automático do EKS em um cluster existente
<a name="auto-enable-existing"></a>

Este tópico descreve como habilitar o Modo Automático do EKS nos clusters existentes no Amazon EKS. Habilitar o Modo Automático em um cluster existente requer a atualização das permissões do IAM e a configuração das principais configurações do Modo Automático do EKS. Depois de habilitado, você pode começar a migrar as workloads computacionais existentes para aproveitar as operações simplificadas e o gerenciamento automatizado da infraestrutura do Modo Automático.

**Importante**  
Verifique se você tem a versão mínima necessária de determinados complementos do Amazon EKS instalada antes de habilitar o Modo Automático do EKS. Para obter mais informações, consulte [Versões de complementos necessárias](#auto-addons-required).

Antes de começar, certifique-se de ter acesso de administrador ao seu cluster do Amazon EKS e permissões para modificar os perfis do IAM. As etapas neste tópico orientam você a habilitar o Modo Automático usando o Console de gerenciamento da AWS ou a AWS CLI.

## Console de gerenciamento da AWS
<a name="auto-enable-existing-console"></a>

Você deve estar conectado ao Console da AWS com permissão para gerenciar recursos do IAM, EKS e EC2.

**nota**  
O perfil do IAM do cluster de um cluster do EKS não pode ser alterado após a criação do cluster. O Modo Automático do EKS requer permissões adicionais nesse perfil. Você deve anexar políticas adicionais ao perfil atual.

### Atualizar perfil do IAM do cluster
<a name="_update_cluster_iam_role"></a>

1. Abra a página de visão geral do cluster no Console de gerenciamento da AWS.

1. Em **ARN do perfil do IAM do cluster**, selecione **Visualizar no IAM**.

1. Na lista suspensa **Adicionar permissões**, selecione **Anexar políticas**.

1. Use a caixa **Pesquisar** para encontrar e selecionar as seguintes políticas:
   +  `AmazonEKSComputePolicy` 
   +  `AmazonEKSBlockStoragePolicy` 
   +  `AmazonEKSLoadBalancingPolicy` 
   +  `AmazonEKSNetworkingPolicy` 
   +  `AmazonEKSClusterPolicy` 

1. Selecione **Adicionar permissões**. 

1. Na guia **Relacionamentos de confiança**, selecione **Editar política de confiança**. 

1. Insira a política de confiança a seguir do perfil do IAM do cluster e selecione **Atualizar política** 

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "eks.amazonaws.com"
      },
      "Action": [
        "sts:AssumeRole",
        "sts:TagSession"
      ]
    }
  ]
}
```

### Habilitar o Modo Automático do EKS
<a name="_enable_eks_auto_mode"></a>

1. Abra a página de visão geral do cluster no Console de gerenciamento da AWS.

1. Em **Modo Automático do EKS**, selecione **Gerenciar**. 

1. Alterne o **Modo Automático do EKS** para ativado.

1. No menu suspenso **Grupo de nós do EKS**, selecione os grupos de nós padrão que você deseja criar.
   + Saiba mais sobre grupos de nós no Modo Automático do EKS. Para obter mais informações, consulte [Criar um grupo de nós para o Modo Automático do EKS](create-node-pool.md).

1. Se você já criou um perfil do IAM do nó do Modo Automático do EKS nesta conta da AWS, selecione-a no menu suspenso **Perfil do IAM do nó**. Se você ainda não criou esse perfil, selecione **Criar perfil recomendado** e siga as etapas.

## AWS CLI
<a name="shared_aws_cli"></a>

### Pré-requisitos
<a name="_prerequisites"></a>
+ O perfil do IAM do cluster do cluster existente do EKS deve incluir permissões suficientes para o Modo Automático do EKS, como as seguintes políticas:
  +  `AmazonEKSComputePolicy` 
  +  `AmazonEKSBlockStoragePolicy` 
  +  `AmazonEKSLoadBalancingPolicy` 
  +  `AmazonEKSNetworkingPolicy` 
  +  `AmazonEKSClusterPolicy` 
+ O perfil do IAM do cluster deve ter uma política de confiança atualizada, incluindo a ação `sts:TagSession`. Para obter mais informações sobre como criar um perfil do IAM do cluster, consulte [Criar um cluster do Modo Automático do EKS com a AWS CLI](automode-get-started-cli.md).
+  `aws` CLI instalada, com login efetuado e em uma versão suficiente. Você deve ter permissão para gerenciar recursos do IAM, EKS e EC2. Para obter mais informações, consulte [Configurar para usar o Amazon EKS](setting-up.md).

### Procedimento
<a name="_procedure"></a>

Use os comandos a seguir para habilitar o Modo Automático do EKS em um cluster existente.

**nota**  
Os recursos de computação, armazenamento em blocos e balanceamento de carga devem estar todos habilitados ou desabilitados na mesma solicitação.

```
aws eks update-cluster-config \
 --name $CLUSTER_NAME \
 --compute-config enabled=true \
 --kubernetes-network-config '{"elasticLoadBalancing":{"enabled": true}}' \
 --storage-config '{"blockStorage":{"enabled": true}}'
```

## Versões de complementos necessárias
<a name="auto-addons-required"></a>

Se você planeja habilitar o Modo Automático do EKS em um cluster existente, talvez seja necessário atualizar alguns complementos. Observação:
+ Isso se aplica somente aos clusters existentes em transição para o Modo Automático do EKS.
+ Novos clusters criados com o Modo Automático do EKS habilitado não exigem essas atualizações.

Se você tiver algum dos seguintes complementos instalados, verifique se eles estão pelo menos na versão mínima especificada:


| Nome do complemento | Versão mínima necessária | 
| --- | --- | 
|  Plug-in CNI da Amazon VPC para Kubernetes  |  v1.19.0-eksbuild.1  | 
|  Kube-proxy  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/eks/latest/userguide/auto-enable-existing.html)  | 
|  Driver da CSI do Amazon EBS  |  v1.37.0-eksbuild.1  | 
|  Controlador de snapshots da CSI  |  v8.1.0-eksbuild.2  | 
|  Atendente de Identidade de Pods do EKS  |  v1.3.4-eksbuild.1  | 

Para obter mais informações, consulte [Atualizar um complemento do Amazon EKS](updating-an-add-on.md).

## Próximas etapas
<a name="_next_steps"></a>
+ Para migrar as workloads de Gerenciar grupos de nós, consulte [Migrar dos grupos de nós gerenciados pelo EKS para o Modo Automático do EKS](auto-migrate-mng.md).
+ Para migrar do Karpenter autogerenciado, consulte [Migrar do Karpenter para o Modo Automático do EKS usando o kubectl](auto-migrate-karpenter.md).