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.
Seções
- Pré-requisitos
- Instale e desinstale a AWS CLI versão 1 no Linux usando o instalador incluído
- Instale e desinstale a AWS CLI versão 1 usando pip
- Instale e desinstale a AWS CLI versão 1 usando o Snapcraft
- Adicione o executável da AWS CLI versão 1 ao seu caminho de linha de comando
- Solução de problemas de erros de AWS CLI instalação e desinstalação
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 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.
Tópicos
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.zip
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 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
-
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.zip
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 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-
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
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
-
Execute o programa de instalação. O instalador instala o AWS CLI at
/usr/local/aws
e cria o link simbólicoaws
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 entrandoaws
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 -
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.zip
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 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.zip
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 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-
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 o AWS CLI at
/usr/local/aws
e cria o link simbólicoaws
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 symlinkaws
. É 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 ambientePATH
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 -
Certifique-se de que a AWS CLI versão 1 faça parte da sua
PATH
variável no diretório.-
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
.
-
-
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/bin
neste exemplo na frente da variávelPATH
existente. -
Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor.
$
source ~/
.bash_profile
-
-
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
-
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
-
(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
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
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
-
Execute o script com o comando
python
oupython3
para baixar e instalar a versão mais recente dopip
e de outros pacotes de suporte necessários. Quando você inclui a chave--user
, o script instala opip
no caminho~/.local/bin
.$
python3 get-pip.py --user
-
Verifique se o diretório que contém o
pip
faz 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
,.profile
ou.bash_login
-
Zsh:
.zshrc
-
Tcsh:
.tcshrc
,.cshrc
ou.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/bin
neste exemplo na frente da variávelPATH
existente. -
Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor.
$
source ~/
.bash_profile
-
-
Para verificar se
pip
oupip3
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
-
Use o comando
pip
oupip3
para instalar ou atualizar a AWS CLI. Se você usar o Python versão 3 ou posterior, recomendamos usar o comandopip3
. O--user
switchpip
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ão1.16.312
seria==1.16.312
resultando 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 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
-
Se você instalou a AWS CLI versão 1 usando
pip
, 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
oupip3
. Use oaws --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.
-
(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
Tópicos
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
.
-
Instale o Snapcraft na sua plataforma. Para obter informações sobre como instalar o Snapcraft, consulte Instalando o daemon na documentação
do Snap. -
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 comunsna documentação do Snap. -
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
-
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
-
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
-
Se você instalou a AWS CLI versão 1 usando
snap
, 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.
-
(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
-
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/bin
neste exemplo, para a variávelPATH
atual. -
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.