Instale, atualize e desinstale a AWS CLI versão 1 no macOS - AWS Command Line Interface
Pré-requisitosInstalar e desinstalar usando o instalador empacotadoInstalar e atualizar usando pipSolução de problemas de erros de AWS CLI instalação e desinstalação

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á.

Instale, atualize e desinstale a AWS CLI versão 1 no macOS

Você pode instalar a AWS Command Line Interface (AWS CLI) versão 1 e suas dependências no macOS usando o instalador incluído ou. pip

Pré-requisitos

Antes de instalar a AWS CLI versão 1 no macOS, verifique se você tem 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 a versões do 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, atualize e desinstale a AWS CLI versão 1 no macOS usando o instalador incluído

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

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 macOS.

Veja a seguir um resumo dos comandos de instalação 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 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
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 de uma das seguintes formas:

    • 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 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 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 (descompacte) os arquivos do pacote. Se você não tiver unzip, use o gerenciador de pacote integrado da distribuição do macOS 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 na /usr/local/bin pasta. Usar a opção -b para a criação de um symlink elimina a necessidade de especificar a pasta 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 usá-la 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.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Se houver um erro, consulte Solucionar problemas de erros 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 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. Faça o download do instalador incluído na 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 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 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, 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 no diretório especificado.

    $ ./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 pasta na AWS CLI qual a versão 1 está instalada faça parte da sua $PATH variável.

    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.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Se houver um erro, consulte Solucionar problemas de erros AWS CLI.

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

  1. O instalador empacotado coloca tudo dentro do diretório de instalação, exceto o symlink opcional, portanto, para desinstalar, basta excluir esses dois itens.

    $ sudo rm -rf /usr/local/aws
$ sudo rm /usr/local/bin/aws

  2. (Opcional) Remova o AWS SDK compartilhado e AWS CLI as informações de configurações da .aws pasta.

    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, ela não poderá ser acessada por nenhum AWS SDK que ainda esteja no seu sistema.

    O local padrão da pasta .aws difere 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 usar sudo.

    $ sudo rm ~/.aws/

Instale, atualize e desinstale a AWS CLI versão 1 usando pip

Também é possível usar o pip diretamente para instalar 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. 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 na pasta 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

Instale e atualize o AWS CLI usando o pip

  1. Use o comando pip ou pip3 para instalar a AWS CLI. Se você usar o Python versão 3 ou posterior, recomendamos usar o comando pip3.

    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, 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.32.65 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6

    Se o programa não for encontrado, adicione-o ao caminho da linha de comando.

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

Após a instalação com o pip, talvez seja necessário adicionar o programa aws à variável de ambiente PATH do seu sistema operacional. A localização do programa depende de onde o Python está instalado.

exemplo AWS CLI local de instalação - macOS com Python 3.6 e (modo de usuário) pip
~/Library/Python/3.7/bin

Substitua a versão do Python que você tem pela versão do exemplo anterior.

Se você não souber onde o Python está instalado, execute which python.

$ which python
/usr/local/bin/python

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

$ ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python3.7

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

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 o AWS SDK compartilhado e AWS CLI as informações de configurações da .aws pasta.

    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, ela não poderá ser acessada por nenhum AWS SDK que ainda esteja no seu sistema.

    O local padrão da pasta .aws difere 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 usar sudo.

    $ sudo rm ~/.aws/

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 Solucionar problemas de erros 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.