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.

Instalar a versão atual da AWS CLI

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.

Atualizar para a versão mais recente da AWS CLI

Recomendamos que você verifique regularmente se há uma nova versão da AWS CLI e faça a atualização quando possível.

Use o comando pip list -o para verificar quais pacotes estão desatualizados:

$ aws --version aws-cli/1.16.170 Python/3.7.3 Linux/4.14.123-111.109.amzn2.x86_64 botocore/1.12.160 $ pip3 list -o Package Version Latest Type ---------- -------- -------- ----- awscli 1.16.170 1.16.198 wheel botocore 1.12.160 1.12.188 wheel

Como o comando anterior mostra que há uma versão mais recente da AWS CLI disponível, é possível executar pip install --upgrade para obter a versão mais recente:

$ pip3 install --upgrade --user awscli Collecting awscli Downloading https://files.pythonhosted.org/packages/dc/70/b32e9534c32fe9331801449e1f7eacba6a1992c2e4af9c82ac9116661d3b/awscli-1.16.198-py2.py3-none-any.whl (1.7MB) |████████████████████████████████| 1.7MB 1.6MB/s Collecting botocore==1.12.188 (from awscli) Using cached https://files.pythonhosted.org/packages/10/cb/8dcfb3e035a419f228df7d3a0eea5d52b528bde7ca162f62f3096a930472/botocore-1.12.188-py2.py3-none-any.whl Requirement already satisfied, skipping upgrade: docutils>=0.10 in ./venv/lib/python3.7/site-packages (from awscli) (0.14) Requirement already satisfied, skipping upgrade: rsa<=3.5.0,>=3.1.2 in ./venv/lib/python3.7/site-packages (from awscli) (3.4.2) Requirement already satisfied, skipping upgrade: colorama<=0.3.9,>=0.2.5 in ./venv/lib/python3.7/site-packages (from awscli) (0.3.9) Requirement already satisfied, skipping upgrade: PyYAML<=5.1,>=3.10; python_version != "2.6" in ./venv/lib/python3.7/site-packages (from awscli) (3.13) Requirement already satisfied, skipping upgrade: s3transfer<0.3.0,>=0.2.0 in ./venv/lib/python3.7/site-packages (from awscli) (0.2.0) Requirement already satisfied, skipping upgrade: jmespath<1.0.0,>=0.7.1 in ./venv/lib/python3.7/site-packages (from botocore==1.12.188->awscli) (0.9.4) Requirement already satisfied, skipping upgrade: urllib3<1.26,>=1.20; python_version >= "3.4" in ./venv/lib/python3.7/site-packages (from botocore==1.12.188->awscli) (1.24.3) Requirement already satisfied, skipping upgrade: python-dateutil<3.0.0,>=2.1; python_version >= "2.7" in ./venv/lib/python3.7/site-packages (from botocore==1.12.188->awscli) (2.8.0) Requirement already satisfied, skipping upgrade: pyasn1>=0.1.3 in ./venv/lib/python3.7/site-packages (from rsa<=3.5.0,>=3.1.2->awscli) (0.4.5) Requirement already satisfied, skipping upgrade: six>=1.5 in ./venv/lib/python3.7/site-packages (from python-dateutil<3.0.0,>=2.1; python_version >= "2.7"->botocore==1.12.188->awscli) (1.12.0) Installing collected packages: botocore, awscli Found existing installation: botocore 1.12.160 Uninstalling botocore-1.12.160: Successfully uninstalled botocore-1.12.160 Found existing installation: awscli 1.16.170 Uninstalling awscli-1.16.170: Successfully uninstalled awscli-1.16.170 Successfully installed awscli-1.16.198 botocore-1.12.188

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

Definir o caminho para incluir a AWS CLI

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

Configurar a AWS CLI com suas credenciais

Antes de executar um comando da CLI, você deve configurar a AWS CLI com suas credenciais.

Você armazena informações de credenciais localmente definindo perfis nos arquivos de configuração da AWS CLI, que são armazenados por padrão no diretório inicial do usuário. Para obter mais informações, consulte Configurar o AWS CLI.

nota

Se você estiver executando em uma instância do Amazon EC2, as credenciais podem ser recuperadas automaticamente dos metadados da instância. Para obter mais informações, consulte Metadados da instância.

Atualizar para a versão mais recente da AWS CLI

A AWS CLI é atualizado regularmente para ser compatível com novos serviços e comandos. Para atualizar para a versão mais recente da 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

Como desinstalar a AWS CLI

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