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

# Tutorial
<a name="tutorial"></a>

Este tópico mostra como instalar e configurar o eksctl e, em seguida, usá-lo para criar um cluster Amazon EKS.

## Etapa 1: instalar o eksctl
<a name="_step_1_install_eksctl"></a>

Conclua as etapas a seguir para baixar e instalar a versão mais recente do eksctl em seu dispositivo Linux ou macOS:

 **Para instalar o eksctl com o Homebrew** 

1. [(Pré-requisito) Instale o Homebrew.](https://brew.sh/)

1. Adicione o toque da AWS:

   ```
   brew tap aws/tap
   ```

1. Instalar o eksctl

   ```
   brew install aws/tap/eksctl
   ```

Antes de usar o eksctl, conclua estas etapas de configuração:

1. Pré-requisitos de instalação:
   +  [Instale a AWS CLI versão](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 2.x ou posterior.
   + Instale o [kubectl](https://formulae.brew.sh/formula/kubernetes-cli) usando o Homebrew:

     ```
     brew install kubernetes-cli
     ```

1.  [Configure as credenciais da AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) em seu ambiente:

   ```
   aws configure
   ```

1. Verifique a configuração do AWS CLI:

   ```
   aws sts get-caller-identity
   ```

## Etapa 2: criar o arquivo de configuração do cluster
<a name="_step_2_create_cluster_config_file"></a>

Crie um arquivo de configuração de cluster usando estas etapas:

1. Crie um novo arquivo chamado`cluster.yaml`:

   ```
   touch cluster.yaml
   ```

1. Adicione a seguinte configuração básica de cluster:

   ```
   apiVersion: eksctl.io/v1alpha5
   kind: ClusterConfig
   
   metadata:
      name: basic-cluster
      region: us-west-2
   
   nodeGroups:
      - name: ng-1
        instanceType: m5.large
        desiredCapacity: 2
        minSize: 1
        maxSize: 3
        ssh:
           allow: false
   ```

1. Personalize a configuração:
   + Atualize o `region` para corresponder à sua região da AWS desejada.
   + Modifique o `instanceType` com base em seus requisitos de carga de trabalho.
   + Ajuste o`desiredCapacity`,`minSize`, e de `maxSize` acordo com suas necessidades.

1. Valide o arquivo de configuração:

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

## Etapa 3: criar um cluster
<a name="_step_3_create_cluster"></a>

Siga estas etapas para criar seu cluster EKS:

1. Crie o cluster usando o arquivo de configuração:

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

1. Aguarde a criação do cluster (isso normalmente leva de 15 a 20 minutos).

1. Verifique a criação do cluster:

   ```
   eksctl get cluster
   ```

1. Configure o kubectl para usar seu novo cluster:

   ```
   aws eks update-kubeconfig --name basic-cluster --region us-west-2
   ```

1. Verifique a conectividade do cluster:

   ```
   kubectl get nodes
   ```

Seu cluster agora está pronto para uso.

### Opcional: Excluir cluster
<a name="_optional_delete_cluster"></a>

Lembre-se de excluir o cluster quando terminar para evitar cobranças desnecessárias:

```
eksctl delete cluster -f cluster.yaml
```

**nota**  
A criação de clusters pode incorrer em cobranças da AWS. Certifique-se de revisar [os preços do Amazon EKS](https://aws.amazon.com/eks/pricing/) antes de criar um cluster.

## Próximas etapas
<a name="_next_steps"></a>
+ Configurar o Kubectl para se conectar ao cluster
+ Implantar uma aplicação de amostra