AWS Command Line Interface
Guia do usuário

Instalar do AWS CLI

Formas de instalar a AWS Command Line Interface (AWS CLI)

Pré-requisitos

  • Python 2 versão 2.6.5+ ou Python 3 versão 3.3+

  • Windows, Linux, macOS, or Unix

nota

As versões mais recentes do Python podem não funcionar com todos os serviços da AWS. Se você vir InsecurePlatformWarning ou notificações de substituição quando instalar ou usar a AWS CLI, atualize para uma versão mais recente.

Você pode encontrar o número da versão mais recente da CLI em: https://github.com/aws/aws-cli/blob/master/CHANGELOG.rst.

Neste guia, os comandos mostrados presumem que você tenha o Python v3 instalado e os comandos pip mostrados usem a versão pip3.

Instalar a AWS CLI usando o pip

O método de distribuição principal da AWS CLI no Linux, no Windows e no macOS é o pip. Esse é um gerenciador de pacote para o Python que fornece uma maneira fácil de instalar, atualizar e remover pacotes Python e suas dependências.

Versão AWS CLI atual

O AWS CLI é atualizado com frequência para se tornar compatível com novos serviços e comandos. Para determinar se a versão mais recente está instalada, consulte a página de versões no GitHub.

Se você já tem o pip e uma versão compatível do Python, é possível instalar a AWS CLI usando o seguinte comando. Se você tiver o Python versão 3+ instalado, recomendamos usar o comando pip3.

$ pip3 install awscli --upgrade --user

A opção --upgrade informa ao pip3 para atualizar os requisitos que já estão instalados. A opção --user informa ao pip3 para instalar o programa em um subdiretório do seu diretório de usuário para evitar a modificação de bibliotecas usadas pelo seu sistema operacional.

Instalar a AWS CLI em um ambiente virtual

Caso haja problemas ao tentar instalar a AWS CLI com o pip3, é possível instalar a AWS CLI em um ambiente virtual para isolar a ferramenta e suas dependências. Ou você pode usar uma versão do Python diferente da que você normalmente usa.

Instalar a AWS CLI usando um instalador

Para instalações automatizadas ou off-line fornecidas no Linux, macOS, or Unix, experimente o pacote do instalador. O pacote de instalador inclui o AWS CLI, suas dependências e um script de shell que executa a instalação para você.

No Windows, também é possível usar o instalador MSI. Os dois métodos simplificam a instalação inicial. No entanto, a desvantagem é que é mais difícil atualizar quando uma nova versão da AWS CLI é lançada.

Etapas a serem realizadas após a instalação

Após instalar a AWS CLI, talvez seja preciso adicionar o caminho para o arquivo executável à sua variável PATH. Para instruções específicas da plataforma, consulte os seguintes tópicos:

Verifique se a AWS CLI foi instalada corretamente executando aws --version.

$ aws --version aws-cli/1.16.116 Python/3.6.8 Linux/4.14.77-81.59-amzn2.x86_64 botocore/1.12.106

O AWS CLI é atualizado regularmente para ser compatível com novos serviços e comandos. Para atualizar para a versão mais recente do AWS CLI, execute o comando de instalação novamente. Para obter detalhes sobre a versão mais recente da AWS CLI, consulte as notas de release da AWS CLI.

$ pip3 install awscli --upgrade --user

Se precisar desinstalar a AWS CLI, use pip uninstall.

$ pip3 uninstall awscli

Se não tem o Python nem o pip, use o procedimento para o seu ambiente.

Instruções detalhadas para cada ambiente