Instalação, atualização e desinstalação da AWS CLI versão 1 no macOS

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

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-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 a AWS CLI no /usr/local/aws e cria o symlink aws na pasta /usr/local/bin. 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 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 usá-la 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.40.41 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 da AWS CLI.

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

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, 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 no diretório especificado.

   $ ./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 a pasta na qual a AWS CLI versão 1 está instalada 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.40.41 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 da AWS CLI.

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 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 o seu usuário tiver permissão de gravação nesse diretório, não será necessário usar sudo.

   $ sudo rm ~/.aws/

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

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

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

1. Se você instalou a AWS CLI versão 1 usando pip, também será necessário desinstalá-la usando pip.

   $ 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 comando aws --version para determinar a versão do Python associada à AWS CLI versão 1 instalada.

   $ 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 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 o seu usuário tiver permissão de gravação nesse diretório, não será necessário usar sudo.

   $ sudo rm -rf ~/.aws/