Instalar, atualizar e desinstalar a AWS CLI versão 1 no Linux - AWS Command Line Interface

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Instalar, atualizar e desinstalar a AWS CLI versão 1 no Linux

É possível instalar a AWS Command Line Interface (AWS CLI) versão 1 e suas dependências na maioria das distribuições do Linux usando o gerenciador de pacotes pip ou o instalador empacotado.

Embora o pacote awscli esteja disponível em repositórios para outros gerenciadores de pacotes, como apt e yum, eles não são produzidos, gerenciados nem têm suporte da AWS. Recomendamos que você instale a AWS CLI apenas dos pontos de distribuição oficiais da AWS, conforme documentado neste guia.

Pré-requisitos

Você também deve ter o Python 3.6 ou posterior instalado. Para obter instruções de instalação, consulte a página Downloading Python no Beginner's Guide do Python.

Atenção

O Python 2.7 foi descontinuado pela Python Software Foundation em 1º de janeiro de 2020. A partir da AWS CLI versão 1.20.0, é necessária uma versão mínima do Python 3.6.

Para usar a AWS CLI versão 1 com uma versão anterior do Python, você precisará instalar uma versão anterior da AWS CLI versão 1. Para visualizar a matriz de suporte a versões do Python para a AWS CLI versão 1, consulte Requisitos da versão do Python.

Instalar e desinstalar a AWS CLI versão 1 no Linux usando o instalador empacotado

No Linux ou macOS, é possível usar o instalador empacotado para instalar a versão 1 da AWS CLI. O pacote de instalador inclui todas as dependências do pacote e pode ser usado offline.

nota

O pacote de instalador fornecido não é compatível com a instalação em caminhos com espaços.

Instalar a AWS CLI versão 1 usando o instalador empacotado com sudo

As etapas a seguir permitem que você instale a AWS CLI versão 1 via linha de comando em qualquer compilação do Linux ou do macOS.

Veja a seguir um resumo dos comandos de instalação explicados a seguir que você pode recortar e colar para executar como um único conjunto de comandos.

Para a versão mais recente da AWS CLI, use o seguinte bloco de comandos:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão 1.16.312 seria awscli-bundle-1.16.312.zip, o que resultaria no seguinte comando:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Siga estas etapas a partir da linha de comando para instalar a AWS CLI versão 1 usando o instalador empacotado.

Para instalar a AWS CLI versão 1 usando o instalador empacotado

  1. Baixe o instalador empacotado da AWS CLI versão 1 usando um dos seguintes métodos.

    • Faça download usando o comando curl.

      Para a versão mais recente da AWS CLI, use o seguinte bloco de comandos:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão 1.16.312 seria awscli-bundle-1.16.312.zip, o que resultaria no seguinte comando:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Baixe usando o link direto.

      Para a versão mais recente da AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão 1.16.312 seria awscli-bundle-1.16.312.zip, o que resultaria no seguinte URL: https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. Extraia os arquivos do pacote. Se você não tiver unzip para extrair os arquivos, use a distribuição do Linux incluída no gerenciador de pacote para fazer a instalação.

    $ unzip awscli-bundle.zip
  3. Execute o programa de instalação. O instalador instala a AWS CLI no /usr/local/aws e cria o symlink aws no diretório /usr/local/bin. Usar a opção -b para criar um symlink elimina a necessidade de especificar o diretório de instalação na variável $PATH do usuário. Isso permite que todos os usuários chamem a AWS CLI ao inserir aws de qualquer diretório.

    $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

    Por padrão, o script de instalação é executado sob a versão padrão do sistema do Python. Se uma versão diferente do Python estiver instalada e você quiser usar essa versão para instalar a AWS CLI, execute o script de instalação com essa versão por caminho absoluto para o Python executável, conforme indicado a seguir.

    $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
  4. Verifique se o AWS CLI está instalado corretamente.

    $ aws --version aws-cli/1.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

Instalar a AWS CLI versão 1 usando o instalador empacotado sem sudo

Caso não tenha permissões sudo ou deseje instalar a AWS CLI apenas para o usuário atual, você pode usar uma versão modificada dos comandos anteriores. Os dois primeiros comandos são os mesmos.

Para a versão mais recente da AWS CLI, use o seguinte bloco de comandos:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws

Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Para este exemplo, o nome do arquivo para a versão 1.16.312 seria awscli-bundle-1.16.312.zip, o que resultaria no seguinte comando:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws

Para instalar a AWS CLI versão 1 para o usuário atual

  1. Baixe o instalador empacotado da AWS CLI versão 1 de uma das seguintes maneiras.

    • Faça download usando o comando curl.

      Para a versão mais recente da AWS CLI, use o seguinte bloco de comandos:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão 1.16.312 seria awscli-bundle-1.16.312.zip, o que resultaria no seguinte comando:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Baixe usando o link direto.

      Para a versão mais recente da AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão 1.16.312 seria awscli-exe-linux-aarch64-2.0.30.zip, o que resultaria no seguinte URL: https://s3.amazonaws.com/aws-cli/awscli-bundle-2.0.30.zip

  2. Extraia os arquivos do pacote usando unzip. Se você não tiver unzip, use a distribuição do Linux incluída no gerenciador de pacote para fazer a instalação.

    $ unzip awscli-bundle.zip
  3. Execute o programa de instalação. O instalador instala a AWS CLI no /usr/local/aws e cria o symlink aws no diretório /usr/local/bin. O comando usa o parâmetro -b para especificar o diretório no qual o instalador coloca o arquivo symlink aws. É necessário ter permissões de gravação na pasta especificada.

    $ ./awscli-bundle/install -b ~/bin/aws

    Isso instalará a AWS CLI no local padrão (~/.local/lib/aws) e criará um link simbólico (symlink) em ~/bin/aws. Verifique se o ~/bin está na sua variável de ambiente PATH para que o symlink funcione.

    $ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't) $ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
  4. Verifique se o diretório da AWS CLI versão 1 faz parte da 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
  5. Verifique se o AWS CLI está instalado corretamente.

    $ aws --version aws-cli/1.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

Desinstalar o instalador empacotado da AWS CLI versão 1

  1. Se você instalou a AWS CLI usando o instalador empacotado, siga estas instruções. O pacote de instalador não retira nada do diretório de instalação, exceto o symlink opcional. Portanto, a desinstalação é feita da mesma maneira destes dois itens.

    $ sudo rm -rf /usr/local/aws $ sudo rm /usr/local/bin/aws
  2. (Opcional) Remova as informações compartilhadas do AWS SDK e das configurações da AWS CLI na pasta .aws.

    Atenção

    Essas configurações de configuração e credenciais são compartilhadas em todos os AWS SDKs e na AWS CLI. Se você remover essa pasta, elas não poderão ser acessadas por nenhum AWS SDK que ainda estiver em seu sistema.

    O local padrão da pasta .aws difere entre plataformas. Por padrão, a pasta está localizada em ~/.aws/. Se a sua conta de usuário tiver permissão de gravação nesse diretório, não será necessário usar sudo.

    $ sudo rm ~/.aws/

Instalar e desinstalar a AWS CLI versão 1 usando pip

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. Execute o pip --version para ver se a sua versão do Linux já inclui o Python e o pip. Se o Python versão 3 ou posterior estiver instalado, recomendamos que você use o comando pip3.

  1. Use o comando curl a seguir para baixar o script de instalação. O comando a seguir usa o parâmetro -O (letra “O” maiúscula) para especificar que o arquivo baixado deve ser armazenado no diretório atual usando o mesmo nome que ele tem no host remoto.

    $ curl -O https://bootstrap.pypa.io/get-pip.py
  2. Execute o script com o comando python ou python3 para baixar e instalar a versão mais recente do pip e de outros pacotes de suporte necessários. Quando você inclui a chave --user, o script instala o pip no caminho ~/.local/bin.

    $ python3 get-pip.py --user
  3. Verifique se o diretório que contém o pip faz parte da 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. Para verificar se pip ou pip3 está instalado corretamente, execute o comando a seguir.

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

Instalar e atualizar a AWS CLI versão 1 usando pip

  1. Use o comando pip ou pip3 para instalar ou atualizar a AWS CLI. Se você usar o Python versão 3 ou posterior, recomendamos usar o comando pip3. O switch --user, pip instala a AWS CLI em ~/.local/bin.

    Para a versão mais recente da AWS CLI, use o seguinte bloco de comandos:

    $ pip3 install awscli --upgrade --user

    Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão 1.16.312 seria ==1.16.312, o que resultaria no seguinte comando:

    $ pip3 install awscli==1.16.312 --upgrade --user
    nota

    Use as regras de aspas apropriadas para o terminal. Para usar o caractere =, você pode precisar usar aspas simples ou duplas para realizar o escape corretamente. O escape de exemplo a seguir usa aspas simples:

    $ pip3 install 'awscli==1.16.312' --upgrade --user
  2. Verifique se o AWS CLI está instalado corretamente.

    $ aws --version aws-cli/1.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando

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

É possível 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

O pip instala programas na mesma pasta que contém o aplicativo Python. Adicione esta pasta à variável PATH.

Como modificar a variável PATH

  1. Encontre o script de perfil do shell no diretório 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 script de perfil.

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

    Este comando adiciona um caminho, ~/.local/bin neste exemplo, para a variável PATH atual.

  3. Carregue o perfil atualizado em sua sessão atual.

    $ source ~/.bash_profile

Desinstalar a AWS CLI usando pip

  1. Se você instalou o AWS CLI usando pip ou pip3, será necessário desinstalar a AWS CLI usando o mesmo gerenciador de pacotes. Para fazer isso, execute um dos comandos a seguir.

    $ pip uninstall awscli
    $ pip3 uninstall awscli
  2. (Opcional) Remova as informações compartilhadas do AWS SDK e das configurações da AWS CLI na pasta .aws.

    Atenção

    Essas configurações de configuração e credenciais são compartilhadas em todos os AWS SDKs e na AWS CLI. Se você remover essa pasta, elas não poderão ser acessadas por nenhum AWS SDK que ainda estiver em seu sistema.

    O local padrão da pasta .aws difere entre plataformas. Por padrão, a pasta está localizada em ~/.aws/. Se a sua conta de usuário tiver permissão de gravação nesse diretório, não será necessário usar sudo.

    $ sudo rm ~/.aws/

Solução de problemas de erros de instalação e desinstalação da AWS CLI

Se você encontrar problemas após instalar ou desinstalar a AWS CLI, consulte Solução de problemas de erros da AWS CLI para obter os passos para a solução de problemas. Para obter os passos mais relevantes para a solução de problemas, consulte Erros de comando não encontrado, O comando “aws --version” retorna uma versão diferente da que você instalou e O comando “aws --version” retorna uma versão após a desinstalação da AWS CLI.