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