Guia Completo: Como Instalar e Configurar o AWS CLI

O **AWS CLI** (Command Line Interface) é uma ferramenta poderosa para gerenciar seus serviços AWS diretamente do terminal. Siga este guia passo a passo para instalá-lo e configurá-lo em **Windows, macOS e Linux**.

Ilustração do AWS CLI em ação com ícones de sistemas operacionais

1. Instalação do AWS CLI

O método de instalação recomendado para a maioria dos sistemas é o uso do instalador `pip` (gerenciador de pacotes do Python). O AWS CLI v2 também oferece instaladores dedicados, que são geralmente mais simples.

Para Windows

Opção 1: Usando o instalador MSI (Recomendado para v2)

  1. Baixe o instalador MSI:
  2. Execute o instalador: Dê um duplo clique no arquivo MSI e siga as instruções.
  3. Verifique a instalação: Abra o Prompt de Comando (ou PowerShell) e digite: 
    aws --version

    Você deverá ver a versão instalada, por exemplo: aws-cli/2.1.29 Python/3.7.4 Windows/10 botocore/2.0.0

Opção 2: Usando `pip` (Para AWS CLI v1 ou se você já tiver Python)

  1. Instale o Python e pip: Baixe de python.org/downloads/. Marque "Add Python to PATH".
  2. Abra o Prompt de Comando (ou PowerShell) como administrador.
  3. Instale o AWS CLI: 
    pip install awscli

    Para atualizar: 

    pip install --upgrade awscli

  4. Verifique a instalação: 
    aws --version

Para macOS

Opção 1: Usando o instalador de pacote (Recomendado para v2)

  1. Baixe o instalador de pacote: 
    curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
  2. Execute o instalador: 
    sudo installer -pkg AWSCLIV2.pkg -target /
  3. Verifique a instalação: Abra o Terminal e digite: 
    aws --version

Opção 2: Usando `pip` (Para AWS CLI v1 ou se você já tiver Python)

  1. Instale o Python e pip: Use Homebrew: 
    brew install python
  2. Abra o Terminal.
  3. Instale o AWS CLI: 
    pip install awscli

    Para atualizar: 

    pip install --upgrade awscli

  4. Verifique a instalação: 
    aws --version

Para Linux

Opção 1: Usando o instalador de pacote (Recomendado para v2)

  1. Baixe o instalador de pacote: 
    curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
  2. Descompacte o arquivo: 
    unzip awscliv2.zip
  3. Execute o programa de instalação: 
    sudo ./aws/install
  4. Verifique a instalação: Abra o Terminal e digite: 
    aws --version

Opção 2: Usando `pip` (Para AWS CLI v1 ou se você já tiver Python)

  1. Instale o Python e pip:

    Debian/Ubuntu:

    sudo apt update
sudo apt install python3-pip

    CentOS/RHEL/Fedora:

    sudo yum install python3-pip
  2. Instale o AWS CLI: 
    pip install awscli

    Para atualizar: 

    pip install --upgrade awscli

  3. Verifique a instalação: 
    aws --version

2. Configuração do AWS CLI

Após a instalação, é crucial configurar suas credenciais para que o AWS CLI possa interagir com sua conta AWS.

Método 1: Usando aws configure (Recomendado para iniciar)

  1. Abra o Terminal/Prompt de Comando e digite: 
    aws configure
  2. O AWS CLI solicitará as seguintes informações:
    • AWS Access Key ID: Exemplo: AKIAIOSFODNN7EXAMPLE.
    • AWS Secret Access Key: Exemplo: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY.

      Como obter suas chaves de acesso: Acesse o console da AWS > Seu nome de usuário > Credenciais de segurança > Chaves de acesso. Crie e baixe sua chave secreta imediatamente, ela só é exibida uma vez!

    • Default region name: A região padrão, como sa-east-1 (São Paulo) ou us-east-1.
    • Default output format: Formato de saída, como json, text ou table. O json é o mais versátil.

    Exemplo de interação:

    AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: sa-east-1
Default output format [None]: json

Método 2: Configurando via variáveis de ambiente

Útil para scripts ou configurações temporárias.

Para Linux/macOS:

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_DEFAULT_REGION=sa-east-1

Para persistir, adicione ao seu arquivo de perfil shell (ex: ~/.bashrc, ~/.zshrc).

Para Windows (Prompt de Comando):

set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
set AWS_DEFAULT_REGION=sa-east-1

Para persistir, configure nas "Variáveis de Ambiente do Sistema".

Método 3: Configurando perfis com aws configure

Gerencie múltiplas contas AWS com diferentes perfis.

Para criar um novo perfil (ex: `dev`):

aws configure --profile dev

Para usar um perfil específico:

aws s3 ls --profile dev

3. Testando a Configuração

Verifique se tudo está funcionando executando um comando simples:

aws s3 ls

Se a instalação e configuração estiverem corretas, você verá uma lista dos seus buckets S3 (ou uma lista vazia, se não tiver nenhum), sem erros de autenticação.

Dicas Adicionais para o AWS CLI

  • Segurança das credenciais: Nunca compartilhe suas chaves de acesso. Use **perfis do IAM** para permissões mínimas e considere **AWS SSO** ou **perfis temporários** para maior segurança.
  • Auto-complete (AWS CLI v2): Ative o auto-complete para facilitar a digitação de comandos.

    Para Linux/macOS:

    echo "complete -C '/usr/local/bin/aws_completer' aws" >> ~/.bashrc
source ~/.bashrc
  • Documentação: Consulte a documentação oficial do AWS CLI para informações aprofundadas.