

 **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.

# Criar um cluster do Modo Automático do EKS com a CLI do eksctl
<a name="automode-get-started-eksctl"></a>

Este tópico mostra como criar um cluster do Modo Automático do Amazon EKS usando a interface de linha de comandos (CLI) do eksctl. Você pode criar um cluster do Modo Automático executando um único comando da CLI ou aplicando um arquivo de configuração YAML. Ambos os métodos fornecem a mesma funcionalidade, com a abordagem de YAML oferecendo um controle mais granular das configurações do cluster.

A CLI do eksctl simplifica o processo de criação e gerenciamento de clusters do Modo Automático do EKS ao lidar com a criação e configuração de recursos subjacentes da AWS. Antes de prosseguir, certifique-se de ter as credenciais e permissões da AWS necessárias configuradas na máquina local. Este guia pressupõe que você esteja familiarizado com os conceitos básicos do Amazon EKS e já tenha instalado as ferramentas de CLI necessárias.

**nota**  
Você deve instalar a versão `0.195.0` ou superior do eksctl. Para obter mais informações, consulte as [versões do eksctl](https://github.com/eksctl-io/eksctl/releases) no GitHub.

## Criar um cluster do Modo Automático do EKS com um comando da CLI
<a name="_create_an_eks_auto_mode_cluster_with_a_cli_command"></a>

Você deve ter as ferramentas da `aws` e do `eksctl` instaladas. Você deve estar conectado à AWS CLI com permissões suficientes para gerenciar recursos da AWS, incluindo: instâncias do EC2, redes do EC2, clusters do EKS e perfis do IAM. Para ter mais informações, consulte [Configurar para usar o Amazon EKS](setting-up.md).

Execute o comando a seguir para criar um cluster do Modo Automático do EKS com

```
eksctl create cluster --name=<cluster-name> --enable-auto-mode
```

## Crie um cluster do Modo Automático do EKS com um arquivo YAML
<a name="_create_an_eks_auto_mode_cluster_with_a_yaml_file"></a>

Você deve ter as ferramentas da `aws` e do `eksctl` instaladas. Você deve estar conectado à AWS CLI com permissões suficientes para gerenciar recursos da AWS, incluindo: instâncias do EC2, redes do EC2, clusters do EKS e perfis do IAM. Para ter mais informações, consulte [Configurar para usar o Amazon EKS](setting-up.md).

Analise as opções de configuração do Modo Automático do EKS no exemplo do recurso ClusterConfig abaixo. Para conferir a especificação completa do ClusterConfig, consulte a [documentação do eksctl](https://eksctl.io/usage/creating-and-managing-clusters/).

 AWS sugere habilitar o Modo Automático do EKS. Se esta for a primeira vez que você cria um cluster do Modo Automático do EKS, deixe o `nodeRoleARN` não especificado criar um perfil do IAM do nó para o Modo Automático do EKS. Caso já tenha um perfil do IAM do nó na conta da AWS, a AWS sugere reutilizá-la.

 AWS sugere não especificar nenhum valor para `nodePools`. O Modo Automático do EKS criará grupos de nós padrão. Você pode usar a API do Kubernetes para criar grupos de nós adicionais.

```
# cluster.yaml
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: <cluster-name>
  region: <aws-region>

iam:
  # ARN of the Cluster IAM Role
  # optional, eksctl creates a new role if not supplied
  # suggested to use one Cluster IAM Role per account
  serviceRoleARN: <arn-cluster-iam-role>

autoModeConfig:
  # defaults to false
  enabled: boolean
  # optional, defaults to [general-purpose, system].
  # suggested to leave unspecified
  # To disable creation of nodePools, set it to the empty array ([]).
  nodePools: []string
  # optional, eksctl creates a new role if this is not supplied
  # and nodePools are present.
  nodeRoleARN: string
```

Salve o arquivo `ClusterConfig` como `cluster.yaml` e use o seguinte comando para criar o cluster:

```
eksctl create cluster -f cluster.yaml
```