Instalando, atualizando e desinstalando a AWS CLI versão 1 no Linux - AWS Command Line Interface

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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Instalando, atualizando e desinstalando a AWS CLI versão 1 no Linux

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

Embora o awscli pacote esteja disponível em repositórios para outros gerenciadores de pacotes, como apt eyum, eles não são produzidos, gerenciados ou suportados pelo AWS. Recomendamos que você instale o somente AWS CLI dos pontos de AWS distribuição oficiais, conforme documentado neste guia.

Pré-requisitos

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

Matriz de suporte da versão Python

AWS CLI versão Versão do Python com suporte
1.32.0: atual Python 3.8 e posterior
1.27.0–1.31.x Python 3.7 e posterior
1.20.0–1.26.x Python 3.6
1.19.0: 1.19.x Python 2.7+, Python 3.6+
1.17 – 1.18.x Python 2.7+, Python 3.4+
1.0 – 1.16.x Python 2.6 e anteriores, Python 3.3 e anteriores

Instale e desinstale a AWS CLI versão 1 no Linux usando o instalador incluído

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.

Instale a AWS CLI versão 1 usando o instalador incluído com sudo

As etapas a seguir permitem que você instale a AWS CLI versão 1 a partir da linha de comando em qualquer versão do Linux ou 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 do AWS CLI, use o seguinte bloco de comando:

$ 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 do 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 awscli-bundle-1.16.312.zipresultaria 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 na linha de comando para instalar a AWS CLI versão 1 usando o instalador incluído.

Para instalar a AWS CLI versão 1 usando o instalador incluído
  1. Baixe o instalador incluído na AWS CLI versão 1 usando um dos métodos a seguir.

    • Faça download usando o comando curl.

      Para a versão mais recente do AWS CLI, use o seguinte bloco de comando:

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

      Para uma versão específica do 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 awscli-bundle-1.16.312.zipresultaria 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 do 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 awscli-bundle-1.16.312.zipresultaria 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 o AWS CLI at /usr/local/aws e cria o link simbólico aws no /usr/local/bin diretório. 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 deve permitir que todos os usuários liguem para o AWS CLI entrando aws em 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 você instalou uma versão alternativa do Python e deseja usar essa versão para instalar o AWS CLI, execute o script de instalação com essa versão pelo caminho absoluto até o executável do Python, da seguinte maneira.

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

    $ aws --version aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

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

Instale a AWS CLI versão 1 usando o instalador incluído sem sudo

Se você não tiver sudo permissões ou quiser instalar o AWS CLI somente para o usuário atual, poderá usar uma versão modificada dos comandos anteriores. Os dois primeiros comandos são os mesmos.

Para a versão mais recente do AWS CLI, use o seguinte bloco de comando:

$ 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 do 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 awscli-bundle-1.16.312.zipresultaria 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 incluído na AWS CLI versão 1 de uma das seguintes formas.

    • Faça download usando o comando curl.

      Para a versão mais recente do AWS CLI, use o seguinte bloco de comando:

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

      Para uma versão específica do 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 awscli-bundle-1.16.312.zipresultaria 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 do 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 awscli-bundle-1.16.312.zipresultaria no seguinte url https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.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 o AWS CLI at /usr/local/aws e cria o link simbólico aws no /usr/local/bin diretório. 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 AWS CLI instala o no local padrão (~/.local/lib/aws) e cria um link simbólico (link simbólico) 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. Certifique-se de que a AWS CLI versão 1 faça parte da sua PATH variável no diretório.

    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 AWS CLI está instalado corretamente.

    $ aws --version aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

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

Desinstale o instalador incluído na AWS CLI versão 1

  1. Se você instalou o AWS CLI usando o instalador incluído, 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 -rf /usr/local/bin/aws
  2. (Opcional) Remova as informações compartilhadas AWS SDK e de AWS CLI configurações na .aws pasta.

    Atenção

    Essas configurações e configurações de credenciais são compartilhadas entre todos AWS SDKs e o. AWS CLI Se você remover essa pasta, ela não poderá ser acessada por nenhuma AWS SDKs que ainda esteja no seu sistema.

    A localização padrão da .aws pasta difere entre as plataformas. Por padrão, a pasta está localizada em ~/.aws/. Se seu usuário tiver permissão de gravação nesse diretório, você não precisará usarsudo.

    $ sudo rm -r ~/.aws/

Instale e desinstale 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 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)

Instale e atualize 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 --user switch pip instala o AWS CLI to~/.local/bin.

    Para a versão mais recente do AWS CLI, use o seguinte bloco de comando:

    $ pip3 install awscli --upgrade --user

    Para uma versão específica do AWS CLI, acrescente dois sinais de igual = 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 resultando 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 AWS CLI está instalado corretamente.

    $ aws --version aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

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

Desinstale o AWS CLI pip usando

  1. Se você instalou a AWS CLI versão 1 usandopip, você também deve desinstalar usandopip.

    $ pip uninstall awscli

    Se você estiver usando o Python versão 2 ou 3, talvez seja necessário usar o comando pip2 ou pip3. Use o aws --version comando para determinar a versão do Python associada à sua AWS CLI versão instalada 1.

    $ pip3 uninstall awscli

    Talvez seja necessário reiniciar a janela do prompt de comando ou o computador para remover todos os arquivos.

  2. (Opcional) Remova as informações compartilhadas AWS SDK e de AWS CLI configurações na .aws pasta.

    Atenção

    Essas configurações e configurações de credenciais são compartilhadas entre todos AWS SDKs e o. AWS CLI Se você remover essa pasta, ela não poderá ser acessada por nenhuma AWS SDKs que ainda esteja no seu sistema.

    A localização padrão da .aws pasta difere entre as plataformas. Por padrão, a pasta está localizada em ~/.aws/. Se seu usuário tiver permissão de gravação nesse diretório, você não precisará usarsudo.

    $ sudo rm -r ~/.aws/

Instale e desinstale a AWS CLI versão 1 usando o Snapcraft

Instalar snap

Se ainda não tiver snap instalado, você pode instalá-lo usando as instruções fornecidas pela Canonical Snapcraft. Execute snap version para ver se sua versão do Linux já incluisnap.

  1. Instale o Snapcraft na sua plataforma. Para obter informações sobre como instalar o Snapcraft, consulte Instalando o daemon na documentação do Snap.

  2. Reinicie o sistema para que suas PATH variáveis sejam atualizadas corretamente. Se você estiver tendo problemas de instalação, siga as etapas em Corrigir problemas comuns na documentação do Snap.

  3. Para verificar se snap está instalado corretamente, execute o comando a seguir.

    $ snap version

Instale e atualize a AWS CLI versão 1 usando o snap

  1. Execute o snap install comando a seguir para a AWS CLI versão 1.

    $ snap install aws-cli --channel=v1/stable --classic

    Dependendo das suas permissões, talvez seja necessário adicionar algo sudo ao seu comando.

    $ sudo snap install aws-cli --channel=v1/stable --classic
  2. Verifique se AWS CLI está instalado corretamente.

    $ aws --version aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

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

Desinstale o AWS CLI usando snap

  1. Se você instalou a AWS CLI versão 1 usandosnap, você também deve desinstalar usandosnap.

    $ snap remove aws-cli

    Talvez seja necessário reiniciar a janela do prompt de comando ou o computador para remover todos os arquivos.

  2. (Opcional) Remova as informações compartilhadas AWS SDK e de AWS CLI configurações na .aws pasta.

    Atenção

    Essas configurações e configurações de credenciais são compartilhadas entre todos AWS SDKs e o. AWS CLI Se você remover essa pasta, ela não poderá ser acessada por nenhuma AWS SDKs que ainda esteja no seu sistema.

    A localização padrão da .aws pasta difere entre as plataformas. Por padrão, a pasta está localizada em ~/.aws/. Se você tiver permissões de gravação nesse diretório, não precisará usarsudo.

    $ sudo rm -r ~/.aws/

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

Depois de instalar com pip ousnap, talvez seja necessário adicionar o aws executável à variável de PATH ambiente do seu sistema operacional.

Você pode verificar qual pasta pip instalou o AWS CLI in 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

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

Se você encontrar problemas após instalar ou desinstalar o AWS CLI, consulte as etapas de solução Solução de problemas de erros para o AWS CLI 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 do AWS CLI.