

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

# Configurar para usar o Amazon EKS
<a name="setting-up"></a>

Para se preparar para o gerenciamento da linha de comando dos clusters do Amazon EKS, é necessário instalar várias ferramentas. Use o seguinte para configurar credenciais, criar e modificar clusters e trabalhar com clusters quando estiverem em execução:
+  [Configurar a AWS CLI](install-awscli.md): obtenha a AWS CLI para configurar e gerenciar os serviços necessários para trabalhar com clusters do Amazon EKS. Em particular, você precisa do AWS CLI para configurar as credenciais, mas também precisa dele com outros serviços do AWS.
+  [Configurar o kubectl e o eksctl](install-kubectl.md): a `eksctl` CLI interage com o AWS para criar, modificar e excluir clusters do Amazon EKS. Depois que um cluster estiver ativo, use o comando `kubectl` de código aberto para gerenciar objetos do Kubernetes nos clusters do Amazon EKS.
+ Configurar um ambiente de desenvolvimento (opcional): considere adicionar as seguintes ferramentas:
  +  **Ferramenta de implantação local**: se você for novo no Kubernetes, considere a possibilidade de instalar uma ferramenta de implantação local, como o [minikube](https://minikube.sigs.k8s.io/docs/) ou o [kind](https://kind.sigs.k8s.io/). Essas ferramentas permitem que você tenha um cluster do Amazon EKS em sua máquina local para testar aplicações.
  +  **Gerenciador de pacotes**: o [Helm](helm.md) é um gerenciador de pacotes popular para Kubernetes que simplifica a instalação e o gerenciamento de pacotes complexos. Com o [Helm](helm.md), fica mais fácil instalar e gerenciar pacotes como o AWS Load Balancer Controller no cluster do Amazon EKS.

## Próximas etapas
<a name="setting-up-next-steps"></a>
+  [Configurar a AWS CLI](install-awscli.md) 
+  [Configuração do kubectl e eksctl](install-kubectl.md) 
+  [Início rápido: implantar uma aplicação Web e armazenar dados](quickstart.md) 

# Configurar a AWS CLI
<a name="install-awscli"></a>

A [AWS CLI](https://aws.amazon.com/cli/) é uma ferramenta de linha de comando para trabalhar com os serviços da AWS, incluindo o Amazon EKS. Ela também é usada para autenticar usuários ou funções do IAM para acessar o cluster do Amazon EKS e outros recursos da AWS da sua máquina local. Para provisionar recursos na AWS com base na linha de comando, você precisará obter um ID de chave de acesso da AWS e uma chave secreta para usar na linha de comando. Em seguida, você precisa configurar essas credenciais na AWS CLI. Se você ainda não instalou a AWS CLI, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html), no * Guia do usuário da AWS Command Line Interface*.

## Para criar uma chave de acesso
<a name="create-access-key"></a>

1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/).

1. Para contas de usuário único ou de vários usuários:
   +  **Conta de usuário único -:**: No canto superior direito, escolha seu nome de usuário AWS para abrir o menu de navegação. Para este exemplo, selecione ** `webadmin` **.
   +  **Conta de vários usuários -:**: Selecione IAM na lista de serviços. No painel do IAM, selecione **Usuários** e escolha o nome do usuário.

1. Selecione **Security credentials (Credenciais de segurança)**.

1. Em **Chaves de acesso**, escolha **Criar chave de acesso**.

1. Escolha **Interface de linha de comandos (CLI)** e, em seguida, escolha **Próximo**.

1. Selecione **Create access key (Criar chave de acesso)**.

1. Selecione **Download do arquivo .csv**.

## Para configurar a CLI do AWS
<a name="configure-cli"></a>

Depois de instalar a AWS CLI, execute as etapas a seguir para configurá-la. Para obter mais informações, consulte [Configurar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html), no * Guia do usuário da AWS Command Line Interface*.

1. Em uma janela de terminal, insira o seguinte comando:

   ```
   aws configure
   ```

   De forma alternativa, é possível configurar um perfil nomeado, como `--profile cluster-admin`. Se você configurar um perfil nomeado na AWS CLI, deverá **sempre** passar esse sinalizador nos comandos subsequentes.

1. Insira credenciais de usuário da AWS. Por exemplo:

   ```
   Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: region-code
   Default output format [None]: json
   ```

## Para obter um token de segurança
<a name="security-token"></a>

Se necessário, execute o seguinte comando para obter um novo token de segurança para a AWS CLI. Para obter mais informações, consulte [get-session-token](https://docs.aws.amazon.com/cli/latest/reference/sts/get-session-token.html) em * AWS CLI Command Reference*.

Por padrão, o token é válido por 15 minutos. Para alterar o tempo limite padrão da sessão, passe o sinalizador `--duration-seconds`. Por exemplo:

```
aws sts get-session-token --duration-seconds 3600
```

Esse comando retorna as credenciais de segurança temporárias para uma sessão CLI AWS. Você verá a seguinte saída de resposta:

```
{
    "Credentials": {
        "AccessKeyId": "ASIA5FTRU3LOEXAMPLE",
        "SecretAccessKey": "JnKgvwfqUD9mNsPoi9IbxAYEXAMPLE",
        "SessionToken": "VERYLONGSESSIONTOKENSTRING",
        "Expiration": "2023-02-17T03:14:24+00:00"
    }
}
```

## Para verificar a identidade do usuário
<a name="verify-identity"></a>

Se necessário, execute o seguinte comando para verificar as credenciais AWS da sua identidade de usuário IAM (como *ClusterAdmin*) para a sessão de terminal.

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

Esse comando retorna o Amazon Resource Name (ARN) da entidade do IAM que está configurada para a AWS CLI. Você verá o seguinte exemplo de saída de resposta:

```
{
    "UserId": "AKIAIOSFODNN7EXAMPLE",
    "Account": "01234567890",
    "Arn": "arn:aws:iam::01234567890:user/ClusterAdmin"
}
```

## Próximas etapas
<a name="install-awscli-next-steps"></a>
+  [Configuração do kubectl e eksctl](install-kubectl.md) 
+  [Início rápido: implantar uma aplicação Web e armazenar dados](quickstart.md) 

# Configurar o `kubectl` e o `eksctl`
<a name="install-kubectl"></a>

**dica**  
 [Registre-se](https://aws-experience.com/emea/smb/events/series/get-hands-on-with-amazon-eks?trk=4a9b4147-2490-4c63-bc9f-f8a84b122c8c&sc_channel=el) para os próximos workshops do Amazon EKS.

Após a AWS CLI ser instalada, há duas outras ferramentas que é necessário instalar para criar e gerenciar seus clusters do Kubernetes:
+  `kubectl`: a ferramenta de linha de comando `kubectl` é a principal ferramenta que você usará para gerenciar recursos em seu cluster do Kubernetes. Esta página descreve como baixar e configurar o binário `kubectl` que corresponde à versão do seu cluster do Kubernetes. Consulte [Instalar ou atualizar o kubectl](#kubectl-install-update).
+  `eksctl`: a ferramenta de linha de comando `eksctl` foi criada para criar clusters de EKS na Nuvem AWS ou on-premises (com o EKS Anywhere), bem como para modificar e excluir esses clusters. Consulte [Instalar eksctl](#eksctl-install-update).

## Instalar ou atualizar o `kubectl`
<a name="kubectl-install-update"></a>

Este tópico ajuda a baixar e instalar ou atualizar o binário `kubectl` no dispositivo. O binário é idêntico às [versões da comunidade upstream](https://kubernetes.io/docs/tasks/tools/#kubectl). O binário não é exclusivo do Amazon EKS ou da AWS. Use as etapas abaixo para obter a versão específica de `kubectl` necessária, embora muitos construtores simplesmente executem `brew install kubectl` para instalá-la.

**nota**  
É necessário usar uma versão do `kubectl` que esteja em uma versão secundária de diferença do ambiente de gerenciamento do cluster do Amazon EKS. Por exemplo, um cliente `1.34` `kubectl` funciona com clusters do Kubernetes `1.33`, `1.34` e `1.35`.

## Etapa 1: verifique se o `kubectl` está instalado
<a name="_step_1_check_if_kubectl_is_installed"></a>

Determine se você já tem o `kubectl` instalado no dispositivo.

```
kubectl version --client
```

Se você tiver `kubectl` instalado no caminho do dispositivo, o resultado de exemplo inclui informações semelhantes às seguintes. Se quiser atualizar a versão instalada atualmente para uma versão posterior, conclua a próxima etapa, certificando-se de instalar a nova versão no mesmo local em que a versão atual está.

```
Client Version: v1.31.X-eks-1234567
```

Se não receber nenhum resultado, você não tem o `kubectl` instalado ou ele não está instalado em um local que esteja no caminho do seu dispositivo.

## Etapa 2: instalar ou atualizar `kubectl`
<a name="_step_2_install_or_update_kubectl"></a>

Instale ou atualize o `kubectl` em um dos seguintes sistemas operacionais:
+  [macOS](#macos_kubectl) 
+  [Linux (amd64)](#linux_amd64_kubectl) 
+  [Linux (arm64)](#linux_arm64_kubectl) 
+  [Windows](#windows_kubectl) 

**nota**  
Se os downloads estiverem lentos para a sua região da AWS das regiões da AWS usadas nesta seção, considere configurar o CloudFront para trazer o conteúdo para frente. Para obter mais informações, consulte [Começar a usar uma distribuição básica do CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/GettingStartedSimpleDistributon.html).

### macOS
<a name="macos_kubectl"></a>

Siga as etapas abaixo para instalar o `kubectl` no macOS. As etapas incluem:
+ Escolher e baixar o binário para a versão do Kubernetes desejada.
+ Opcionalmente, verificar a soma de verificação do binário.
+ Adicionar execução às permissões do binário.
+ Copiar o binário em uma pasta em sua variável PATH.
+ Opcionalmente, adicionar o diretório do binário a sua variável PATH.

Procedimento:

1. Baixe o binário para a versão do Kubernetes do cluster do Amazon S3.
   + Kubernetes `1.35` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.34` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.33` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.32` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.31` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.30` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.29` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/darwin/amd64/kubectl
     ```

1. (Opcional) Verifique o binário baixado com a soma de verificação do `SHA-256` para o seu binário.

   1. Baixe a soma de verificação do `SHA-256` para a versão do Kubernetes do cluster.
      + Kubernetes `1.35` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```

   1. Verifique a soma de verificação `SHA-256` para o binário baixado.

      ```
      openssl sha1 -sha256 kubectl
      ```

   1. Verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo `kubectl.sha256` baixado.

1. Aplique permissões de execução ao binário.

   ```
   chmod +x ./kubectl
   ```

1. Copie o binário em uma pasta em seu `PATH`. Se você já tiver instalado uma versão do `kubectl`, recomendamos criar um `$HOME/bin/kubectl` e garantir que `$HOME/bin` venha primeiro em seu `$PATH`.

   ```
   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
   ```

1. (Opcional) Adicione o caminho `$HOME/bin` ao arquivo de inicialização do shell para que ele esteja configurado quando você abrir um shell.

   ```
   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
   ```

### Linux (amd64)
<a name="linux_amd64_kubectl"></a>

Siga as etapas abaixo para instalar o `kubectl` no Linux (amd64). As etapas incluem:
+ Escolher e baixar o binário para a versão do Kubernetes desejada.
+ Opcionalmente, verificar a soma de verificação do binário.
+ Adicionar execução às permissões do binário.
+ Copiar o binário em uma pasta em sua variável PATH.
+ Opcionalmente, adicionar o diretório do binário a sua variável PATH.

Procedimento:

1. Baixe o binário `kubectl` para a versão do Kubernetes do cluster do Amazon S3.
   + Kubernetes `1.35` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.34` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.33` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.32` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.31` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.30` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.29` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/linux/amd64/kubectl
     ```

1. (Opcional) Verifique o binário baixado com a soma de verificação do `SHA-256` para o seu binário.

   1. Baixe a soma de verificação do `SHA-256` para a versão do Kubernetes do cluster do Amazon S3 usando o comando para a plataforma de hardware do seu dispositivo.
      + Kubernetes `1.35` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```

   1. Verifique a soma de verificação `SHA-256` do binário baixado com um dos comandos a seguir.

      ```
      sha256sum -c kubectl.sha256
      ```

      ou

      ```
      openssl sha1 -sha256 kubectl
      ```

   1. No primeiro, é necessário ver `kubectl: OK`; no segundo, confirme se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo `kubectl.sha256` baixado.

1. Aplique permissões de execução ao binário.

   ```
   chmod +x ./kubectl
   ```

1. Copie o binário em uma pasta em seu `PATH`. Se você já tiver instalado uma versão do `kubectl`, recomendamos criar um `$HOME/bin/kubectl` e garantir que `$HOME/bin` venha primeiro em seu `$PATH`.

   ```
   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
   ```

1. (Opcional) Adicione o caminho `$HOME/bin` ao arquivo de inicialização do shell para que ele esteja configurado quando você abrir um shell.
**nota**  
Essa etapa pressupõe que você esteja usando o shell Bash. Se você estiver usando outro shell, altere o comando para usar o arquivo de inicialização do shell.

   ```
   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
   ```

### Linux (arm64)
<a name="linux_arm64_kubectl"></a>

Siga as etapas abaixo para instalar o `kubectl` no Linux (arm64). As etapas incluem:
+ Escolher e baixar o binário para a versão do Kubernetes desejada.
+ Opcionalmente, verificar a soma de verificação do binário.
+ Adicionar execução às permissões do binário.
+ Copiar o binário em uma pasta em sua variável PATH.
+ Opcionalmente, adicionar o diretório do binário a sua variável PATH.

Procedimento:

1. Baixe o binário `kubectl` para a versão do Kubernetes do cluster do Amazon S3.
   + Kubernetes `1.35` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.34` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.33` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.32` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.31` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.30` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.29` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/linux/arm64/kubectl
     ```

1. (Opcional) Verifique o binário baixado com a soma de verificação do `SHA-256` para o seu binário.

   1. Baixe a soma de verificação do `SHA-256` para a versão do Kubernetes do cluster do Amazon S3 usando o comando para a plataforma de hardware do seu dispositivo.
      + Kubernetes `1.35` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```

   1. Verifique a soma de verificação `SHA-256` do binário baixado com um dos comandos a seguir.

      ```
      sha256sum -c kubectl.sha256
      ```

      ou

      ```
      openssl sha1 -sha256 kubectl
      ```

   1. No primeiro, é necessário ver `kubectl: OK`; no segundo, confirme se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo `kubectl.sha256` baixado.

1. Aplique permissões de execução ao binário.

   ```
   chmod +x ./kubectl
   ```

1. Copie o binário em uma pasta em seu `PATH`. Se você já tiver instalado uma versão do `kubectl`, recomendamos criar um `$HOME/bin/kubectl` e garantir que `$HOME/bin` venha primeiro em seu `$PATH`.

   ```
   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
   ```

1. (Opcional) Adicione o caminho `$HOME/bin` ao arquivo de inicialização do shell para que ele esteja configurado quando você abrir um shell.
**nota**  
Essa etapa pressupõe que você esteja usando o shell Bash. Se você estiver usando outro shell, altere o comando para usar o arquivo de inicialização do shell.

   ```
   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
   ```

### Windows
<a name="windows_kubectl"></a>

Siga as etapas abaixo para instalar o `kubectl` no Windows. As etapas incluem:
+ Escolher e baixar o binário para a versão do Kubernetes desejada.
+ Opcionalmente, verificar a soma de verificação do binário.
+ Copiar o binário em uma pasta em sua variável PATH.
+ Opcionalmente, adicionar o diretório do binário a sua variável PATH.

Procedimento:

1. Abra um terminal do PowerShell.

1. Baixe o binário `kubectl` para a versão do Kubernetes do cluster do Amazon S3.
   + Kubernetes `1.35` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.34` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.33` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.32` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.31` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.30` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.29` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/windows/amd64/kubectl.exe
     ```

1. (Opcional) Verifique o binário baixado com a soma de verificação do `SHA-256` para o seu binário.

   1. Baixe a soma de verificação do `SHA-256` para a versão do Kubernetes do cluster para Windows.
      + Kubernetes `1.35` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.2/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.4/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.8/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```

   1. Verifique a soma de verificação `SHA-256` para o binário baixado.

      ```
      Get-FileHash kubectl.exe
      ```

   1. Verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo `kubectl.sha256` baixado. A saída do PowerShell deve ser uma sequência de caracteres equivalente em maiúsculas.

1. Copie o binário em uma pasta em seu `PATH`. Se você tiver um diretório existente no `PATH` que é usado para utilitários de linha de comando, copie o binário para esse diretório. Caso contrário, execute as etapas a seguir.

   1. Crie um novo diretório para os binários de linha de comando, como `C:\bin`.

   1. Copie o binário `kubectl.exe` no seu novo diretório.

   1. Edite a variável de ambiente `PATH` do sistema ou usuário para adicionar o novo diretório ao `PATH`.

   1. Feche o terminal do PowerShell e abra um novo para escolher a nova variável `PATH`.

1. Depois de instalar `kubectl`, você pode verificar a versão.

   ```
   kubectl version --client
   ```

1. Quando o `kubectl` é instalado pela primeira vez, ele ainda não está configurado para se comunicar com nenhum servidor. Abordaremos essa configuração conforme necessário em outros procedimentos. Se você precisar atualizar a configuração para se comunicar com um determinado cluster específico, poderá executar o comando a seguir. Substitua *region-code* pela região da AWS em que o cluster se encontra. Substitua *my-cluster* pelo nome do cluster.

   ```
   aws eks update-kubeconfig --region region-code --name my-cluster
   ```

1. Considere configurar o preenchimento automático, que permite usar a tecla Tab para preencher os subcomandos do `kubectl` após digitar as primeiras letras. Consulte [Kubectl autocomplete](https://kubernetes.io/docs/reference/kubectl/quick-reference/#kubectl-autocomplete) na documentação do Kubernetes para obter detalhes.

## Instalar o `eksctl`
<a name="eksctl-install-update"></a>

A CLI do `eksctl` é usada para trabalhar com clusters de EKS. Ela automatiza muitas tarefas individuais. Consulte [Instalação](https://eksctl.io/installation) na documentação do `eksctl` para obter instruções sobre instalação do `eksctl`. Para Linux, use as instruções aplicáveis ao UNIX.

Ao usar `eksctl`, a entidade principal de segurança do IAM que você está usando deve ter permissões para trabalhar com perfis do IAM do Amazon EKS, perfis vinculadas a serviços, AWS CloudFormation, um VPC e recursos relacionados. Para obter mais informações, consulte [Ações](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelastickubernetesservice.html) e [uso de perfis vinculadas a serviços](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) no Guia do Usuário do IAM. É necessário concluir todas as etapas deste manual como o mesmo usuário. Execute o seguinte comando para verificar o usuário atual:

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

## Próximas etapas
<a name="install-kubectl-next-steps"></a>
+  [Início rápido: implantar uma aplicação Web e armazenar dados](quickstart.md) 