Como instalar a AWS CLI e executar seu primeiro comando

O que é a AWS CLI, afinal

CLI significa Command Line Interface, interface de linha de comando. A AWS CLI é um programa que você instala no seu computador e que conversa com os serviços da Amazon Web Services (AWS) digitando comandos de texto, em vez de clicar em botões no console pelo navegador. Para quem está começando na nuvem ou estudando para uma certificação, ela é a ferramenta que aparece em quase todo exemplo prático, inclusive em questões de exame que mostram um trecho de comando e pedem o resultado.

Este tutorial segue o guia oficial publicado no AWS Developer Tools Blog, da equipe que mantém a CLI v2, sobre como instalar e atualizar a ferramenta com um único comando por linha. Antes disso, instalar a CLI exigia baixar manualmente o instalador certo para o seu sistema operacional e arquitetura, configurar o caminho de instalação e rodar o instalador na mão.

Antes de começar

Você vai precisar de três coisas: um terminal (Terminal no macOS, qualquer shell no Linux, ou PowerShell no Windows), conexão com a internet, e uma conta AWS (a camada Free Tier, gratuita, já serve). Instalar a CLI é um processo local no seu computador: você baixa e configura um programa na sua máquina, sem depender de nenhum recurso pago da AWS para essa etapa.

Se você ainda não tem conta AWS, crie uma pelo site oficial antes de seguir. Se já tem, não precisa de nada além do terminal aberto.

Instalando no macOS e no Linux

Abra o terminal e rode o comando abaixo. O -fsSL faz o curl baixar o script em silêncio e seguir redirecionamentos; o | bash executa esse script assim que ele termina de baixar, sem salvar nada em disco antes.

curl -fsSL 'https://awscli.amazonaws.com/v2/install.sh' | bash

Por padrão, a instalação é feita só para o seu usuário, em $HOME/.local/share/aws-cli, com atalhos (symlinks) criados em $HOME/.local/bin. Dá para mudar esses caminhos com as variáveis de ambiente XDG_DATA_HOME e XDG_BIN_HOME, caso você já use essa convenção em outras ferramentas.

Se você administra uma máquina compartilhada e quer instalar para todos os usuários, use a flag --system. Isso instala em /usr/local/aws-cli e exige permissão de root:

curl -fsSL 'https://awscli.amazonaws.com/v2/install.sh' | sudo bash -s -- --system

Instalando no Windows

No PowerShell, irm (Invoke-RestMethod) baixa o script e iex (Invoke-Expression) executa o conteúdo baixado na hora:

irm 'https://awscli.amazonaws.com/v2/install.ps1' | iex

Por padrão, a CLI fica instalada só para o seu usuário em %LOCALAPPDATA%\Programs\Amazon\AWSCLIV2. Para instalar para todos os usuários da máquina, abra o PowerShell como administrador e use a flag -System:

irm 'https://awscli.amazonaws.com/v2/install.ps1' -OutFile install.ps1; try { .\install.ps1 -System } finally { Remove-Item install.ps1 }

Esse comando baixa o instalador para um arquivo temporário, roda com -System e apaga o arquivo depois, para não deixar lixo no disco.

Conferindo que a instalação funcionou

Feche e reabra o terminal (isso recarrega as variáveis de ambiente, incluindo o PATH onde o atalho da CLI foi registrado) e rode:

aws --version

O retorno esperado é algo como aws-cli/2.x.x Python/3.x.x <sistema operacional>. Se aparecer command not found: aws no Mac/Linux ou aws não é reconhecido no Windows, o problema quase sempre é esse: o terminal antigo ainda não enxerga o novo PATH. Fechar e abrir o terminal de novo resolve na maioria dos casos; se não resolver, confira se o diretório de instalação ($HOME/.local/bin ou %LOCALAPPDATA%\Programs\Amazon\AWSCLIV2) está mesmo listado na variável PATH do seu sistema.

Fazendo o primeiro comando de verdade

aws --version só confirma que o binário está no lugar; ele não fala com a AWS. Para o primeiro comando que de fato troca informação com a nuvem, use o Security Token Service (STS), o serviço que identifica quem está fazendo a chamada:

aws sts get-caller-identity

Para essa chamada funcionar, a CLI precisa de credenciais configuradas. Se ainda não configurou, rode aws configure primeiro e informe suas credenciais de acesso à AWS; consulte a documentação oficial da AWS sobre configuração de credenciais da CLI para saber como gerá-las e onde encontrá-las. No prompt de região, use sa-east-1, que é a região de São Paulo; no de formato de saída, json funciona bem para começar.

Com as credenciais configuradas, o comando confirma a identidade usada na chamada, retornando essas informações no formato escolhido (por exemplo, JSON).

Se o retorno for um erro do tipo Unable to locate credentials, o arquivo de credenciais está vazio ou não foi criado; confira se existe ~/.aws/credentials (Mac/Linux) ou %USERPROFILE%\.aws\credentials (Windows) e rode aws configure novamente.

Mantendo a CLI atualizada

A partir da versão 2.36.0, atualizar deixou de exigir repetir os passos de instalação. Basta rodar:

aws update

Esse comando detecta o caminho onde a CLI já está instalada e atualiza para a versão mais recente nesse mesmo lugar. Uma ressalva importante: aws update só funciona em instalações feitas pelo instalador oficial, pelo script de instalação mostrado acima, ou pelo próprio aws update em uma atualização anterior. Se você instalou a CLI por outro gerenciador de pacotes de terceiros, o comando pode não reconhecer essa instalação, e nesse caso vale reinstalar pelo script oficial para passar a usar aws update dali em diante.

Para onde ir depois

Com a CLI instalada e o primeiro comando funcionando, o próximo passo natural é testar um comando que lista recursos, como aws s3 ls (lista os buckets de armazenamento da sua conta; se você não tiver nenhum ainda, o retorno vem vazio). Dali, vale criar um usuário IAM com permissões mínimas para o que você vai estudar, em vez de usar credenciais de administrador no dia a dia.

Se travar em algum passo que este tutorial não cobriu, o próprio time da AWS recebe dúvidas e problemas no repositório da CLI no GitHub, canal oficial para relatar bugs de instalação e comportamento inesperado do comando aws update.

Fonte: AWS Developer Tools Blog