AWS Command Line Interface
Guia do usuário

Instalar a AWS CLI no Linux

Instale a AWS Command Line Interface (AWS CLI) e suas dependências na maioria das distribuições do Linux usando o pip, um gerenciador de pacote para Python.

Importante

O pacote awscli está disponível em repositórios para outros gerenciadores de pacote, como apt e yum, mas pode ser que você não obtenha a versão mais recente, a menos que seja obtida por meio do pip ou usando o pacote de instalador.

Caso já tenha pip, siga as instruções no tópico de instalação principal. Execute o pip --version para ver se a sua versão do Linux já inclui o Python e o pip. Se você tiver o Python versão 3+ instalado, recomendamos usar o comando pip3.

$ pip3 --version

Se ainda não tiver o pip instalado, verifique qual versão do Python está instalada.

$ python --version

ou

$ python3 --version

Se você ainda não tem o Python 2 versão 2.6.5+ ou Python 3 versão 3.3+, você deverá primeiro instalar o Python. Se você já tiver o Python instalado, prossiga para instalar o pip e a AWS CLI.

Instalar o pip

Se você ainda não tem o pip instalado, você pode instalá-lo usando o script que o Python Packaging Authority fornece.

Para instalar o pip

  1. Use o comando curl a seguir para fazer download do script de instalação.

    $ curl -O https://bootstrap.pypa.io/get-pip.py
  2. Execute o script com Python para fazer download e instalar a versão mais recente do pip e de outros pacotes de suporte necessários.

    $ python get-pip.py --user

    ou

    $ python3 get-pip.py --user

    Quando você inclui a chave --user, o script instala o pip no caminho ~/.local/bin.

  3. Certifique-se de que a pasta que contém pip faça parte da sua variável PATH.

    1. Encontre o script de perfil do shell em sua pasta de usuário. Se não tiver certeza de qual shell você tem, execute echo $SHELL.

      $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
      • Bash.bash_profile, .profile ou .bash_login

      • Zsh.zshrc

      • Tcsh.tcshrc, .cshrc ou .login

    2. Adicione um comando de exportação ao final do script de perfil que é semelhante ao exemplo a seguir.

      export PATH=~/.local/bin:$PATH

      Esse comando insere o caminho ~/.local/bin neste exemplo na frente da variável PATH existente.

    3. Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor.

      $ source ~/.bash_profile
  4. Agora você pode fazer o teste para verificar se o pip está instalado corretamente.

    $ pip3 --version pip 19.0.3 from ~/.local/lib/python3.7/site-packages (python 3.7)

Instalar a AWS CLI com o pip

Use o pip para instalar a AWS CLI.

$ pip3 install awscli --upgrade --user

Quando você usa a chave --user, o pip instala a AWS CLI como ~/.local/bin.

Verifique se o AWS CLI está instalado corretamente.

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

Se houver um erro, consulte Solução de problemas de erros do AWS CLI.

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

Adicionar o executável da AWS CLI em seu caminho de linha de comando

Após a instalação com o pip, talvez seja necessário adicionar o executável aws à variável de ambiente PATH do seu sistema operacional.

Você pode verificar em qual pasta o pip instalou a AWS CLI executando o comando a seguir.

$ which aws /home/username/.local/bin/aws

Você pode fazer referência a isso como ~/.local/bin/ porque /home/username corresponde a ~ no Linux.

Se você omitiu a chave --user e, portanto, não a instalou no modo usuário, o arquivo executável poderá estar na pasta bin de sua instalação do Python. Se você não souber onde o Python está instalado, execute este comando.

$ which python /usr/local/bin/python

A saída pode ser o caminho para um symlink, e não para o arquivo executável real. Execute ls -al para saber para onde ele aponta.

$ ls -al /usr/local/bin/python /usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6

Se esta for a mesma pasta que adicionou ao caminho na etapa 3 em Instalar o pip, você terá concluído. Caso contrário, execute as mesmas etapas 3a a 3c novamente, adicionando essa pasta adicional ao caminho.