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.
Instalação, atualização e desinstalação da 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.
Seções
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
Matriz de suporte a versões do Python
| Versão do AWS CLI | Versão do Python com suporte |
|---|---|
| 1.39.0: atual | Python 3.9 e posterior |
| 1.32.0-1.38.38 | 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 |
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.
Tópicos
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
-
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.312seriaawscli-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.312seriaawscli-bundle-, o que resultaria no seguinte URL: https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312.zip
-
-
Extraia os arquivos do pacote. Se você não tiver
unzippara extrair os arquivos, use a distribuição do Linux incluída no gerenciador de pacote para fazer a instalação.$unzip awscli-bundle.zip -
Execute o programa de instalação. O instalador instala a AWS CLI no
/usr/local/awse cria o symlinkawsno diretório/usr/local/bin. Usar a opção-bpara criar um symlink elimina a necessidade de especificar o diretório de instalação na variável$PATHdo usuário. Isso permite que todos os usuários chamem a AWS CLI ao inserirawsde qualquer diretório.$sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/awsPor 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.7awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws -
Verifique se o AWS CLI está instalado corretamente.
$aws --versionaws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6Se houver um erro, consulte Solução de problemas 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
-
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.312seriaawscli-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.312seriaawscli-bundle-, o que resultaria no seguinte URL: https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312.zip
-
-
Extraia os arquivos do pacote usando
unzip. Se você não tiverunzip, use a distribuição do Linux incluída no gerenciador de pacote para fazer a instalação.$unzip awscli-bundle.zip -
Execute o programa de instalação. O instalador instala a AWS CLI no
/usr/local/awse cria o symlinkawsno diretório/usr/local/bin. O comando usa o parâmetro-bpara especificar o diretório no qual o instalador coloca o arquivo symlinkaws. É necessário ter permissões de gravação na pasta especificada.$./awscli-bundle/install -b ~/bin/awsIsso instalará a AWS CLI no local padrão (
~/.local/lib/aws) e criará um link simbólico (symlink) em~/bin/aws. Verifique se o~/binestá na sua variável de ambientePATHpara 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 -
Verifique se o diretório da AWS CLI versão 1 faz parte da variável
PATH.-
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,.profileou.bash_login -
Zsh:
.zshrc -
Tcsh:
.tcshrc,.cshrcou.login.
-
-
Adicione um comando de exportação ao final do script de perfil que é semelhante ao exemplo a seguir.
export PATH=~/.local/bin:$PATHEsse comando insere o caminho
~/.local/binneste exemplo na frente da variávelPATHexistente. -
Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor.
$source ~/.bash_profile
-
-
Verifique se o AWS CLI está instalado corretamente.
$aws --versionaws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6Se houver um erro, consulte Solução de problemas da AWS CLI.
Desinstalar o instalador empacotado da AWS CLI versão 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 -rf /usr/local/bin/aws -
(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
.awsdifere entre plataformas. Por padrão, a pasta está localizada em~/.aws/. Se o seu usuário tiver permissão de gravação nesse diretório, não será necessário usarsudo.$sudo rm -r~/.aws/
Instalar e desinstalar a AWS CLI versão 1 usando pip
Tópicos
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.
-
Use o comando
curla 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 -
Execute o script com o comando
pythonoupython3para baixar e instalar a versão mais recente dopipe de outros pacotes de suporte necessários. Quando você inclui a chave--user, o script instala opipno caminho~/.local/bin.$python3 get-pip.py --user -
Verifique se o diretório que contém o
pipfaz parte da variávelPATH.-
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,.profileou.bash_login -
Zsh:
.zshrc -
Tcsh:
.tcshrc,.cshrcou.login.
-
-
Adicione um comando de exportação ao final do script de perfil que é semelhante ao exemplo a seguir.
export PATH=~/.local/bin:$PATHEsse comando insere o caminho
~/.local/binneste exemplo na frente da variávelPATHexistente. -
Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor.
$source ~/.bash_profile
-
-
Para verificar se
pipoupip3está instalado corretamente, execute o comando a seguir.$pip3 --versionpip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
Instalar e atualizar a AWS CLI versão 1 usando pip
-
Use o comando
pipoupip3para instalar ou atualizar a AWS CLI. Se você usar o Python versão 3 ou posterior, recomendamos usar o comandopip3. O switch--user,pipinstala 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 --userPara 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.312seria==1.16.312, o que resultaria no seguinte comando:$pip3 install awscli==1.16.312--upgrade --usernota
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 -
Verifique se o AWS CLI está instalado corretamente.
$aws --versionaws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6Se houver um erro, consulte Solução de problemas da AWS CLI.
Desinstalar a AWS CLI usando pip
-
Se você instalou a AWS CLI versão 1 usando
pip, também será necessário desinstalá-la usandopip.$pip uninstall awscliSe você estiver usando o Python versão 2 ou 3, talvez seja necessário usar o comando
pip2oupip3. Use o comandoaws --versionpara determinar a versão do Python associada à AWS CLI versão 1 instalada.$pip3 uninstall awscliTalvez seja necessário reiniciar a janela do prompt de comando ou o computador para remover todos os arquivos.
-
(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
.awsdifere entre plataformas. Por padrão, a pasta está localizada em~/.aws/. Se o seu usuário tiver permissão de gravação nesse diretório, não será necessário usarsudo.$sudo rm -r~/.aws/
Instalar e desinstalar a AWS CLI versão 1 usando Snapcraft
Tópicos
Instalar o snap
Caso ainda não tenha instalado o snap, você poderá instalá-lo usando as instruções fornecidas pelo Canonical Snapcraft. Execute o snap
version para ver se a sua versão do Linux já inclui o snap.
-
Instale o Snapcraft em sua plataforma. Para obter informações sobre como instalar o Snapcraft, consulte Instalar o daemon
na Documentação do Snap. -
Reinicie o sistema para que suas variáveis
PATHsejam atualizadas corretamente. Se você estiver tendo problemas de instalação, siga as etapas em Corrigir problemas comunsna documentação do snap. -
Para verificar se o
snapestá instalado corretamente, execute o seguinte comando.$snap version
Instalar e atualizar a AWS CLI versão 1 usando snap
-
Execute o seguinte comando
snap installda AWS CLI versão 1.$snap install aws-cli --channel=v1/stable --classicDependendo de suas permissões, pode ser necessário adicionar
sudoao seu comando.$sudo snap install aws-cli --channel=v1/stable --classic -
Verifique se o AWS CLI está instalado corretamente.
$aws --versionaws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6Se houver um erro, consulte Solução de problemas da AWS CLI.
Desinstalar a AWS CLI usando snap
-
Se você instalou a AWS CLI versão 1 usando
snap, também será necessário desinstalá-la usandosnap.$snap remove aws-cliTalvez seja necessário reiniciar a janela do prompt de comando ou o computador para remover todos os arquivos.
-
(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
.awsdifere entre plataformas. Por padrão, a pasta está localizada em~/.aws/. Se você tiver permissões de gravação nesse diretório, não será necessário usarsudo.$sudo rm -r~/.aws/
Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando
Após a instalação com pip ou snap, 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 a aplicação Python. Adicione esta pasta à variável PATH.
Como modificar a variável PATH
-
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
-
-
Adicione um comando de exportação ao script de perfil.
export PATH=~/.local/bin:$PATHEste comando adiciona um caminho,
~/.local/binneste exemplo, para a variávelPATHatual. -
Carregue o perfil atualizado em sua sessão atual.
$source ~/.bash_profile
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 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.