**Esta documentação é somente para a versão 1 da AWS CLI.** Anunciamos o próximo fim do suporte para a AWS CLI versão 1. É recomendável migrar para a AWS CLI versão 2. Para saber as datas e receber detalhes e informações adicionais sobre como migrar, consulte o [anúncio](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Para obter a documentação relacionada à AWS CLI versão 2, consulte o [Guia do usuário da versão 2](https://docs.aws.amazon.com/cli/latest/userguide/). # Instalação, atualização e desinstalação da AWS CLI versão 1 no macOS É possível instalar a AWS Command Line Interface (AWS CLI) versão 1 e suas dependências no macOS usando o instalador empacotado ou o `pip`. **Topics** + [ ## Pré-requisitos ](#install-macosos-prereq) + [ ## Instalar, atualizar e desinstalar a AWS CLI versão 1 no macOS usando o instalador empacotado ](#install-macosos-bundled) + [ ## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando pip ](#awscli-install-osx-pip) + [ ## Solução de problemas de erros de instalação e desinstalação da AWS CLI ](#awscli-install-osx-tshoot) ## Pré-requisitos Antes de instalar a AWS CLI versão 1 no macOS, o Python 3.8 ou posterior deverá ser instalado. Para obter instruções de instalação, consulte a página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) no *Beginner's Guide* do Python. **Matriz de suporte a versões do Python** | AWS CLIVersão do | 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\$1, Python 3.6\$1 | | 1.17 – 1.18.x | Python 2.7\$1, Python 3.4\$1 | | 1.0 – 1.16.x | Python 2.6 e anteriores, Python 3.3 e anteriores | ## Instalar, atualizar e desinstalar a AWS CLI versão 1 no macOS usando o instalador empacotado 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. **Topics** + [ ### Instalar a AWS CLI versão 1 usando o instalador empacotado com `sudo` ](#install-macosos-bundled-sudo) + [ ### Instalar a AWS CLI versão 1 usando o instalador empacotado sem `sudo` ](#install-macosos-bundled-no-sudo) + [ ### Desinstalar o instalador empacotado da AWS CLI versão 1 ](#install-macosos-bundled-uninstall) ### 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 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 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 ``` **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](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](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip) 1. 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 ``` 1. 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 ``` 1. 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](cli-chap-troubleshooting.md). ### 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. 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. 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](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](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip) 1. 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 ``` 1. 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 ``` 1. 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`. 1. 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. 1. Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor. ``` $ source ~/.bash_profile ``` 1. 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](cli-chap-troubleshooting.md). ### Desinstalar o instalador empacotado da 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 ``` 1. **(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 *\$1/.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/ ``` ## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando pip Também é possível usar o `pip` diretamente para instalar a AWS CLI. **Topics** + [ ### Instalar o pip ](#awscli-install-osx-pip-pip) + [ ### Instalar e atualizar a AWS CLI usando pip ](#awscli-install-osx-pip-install) + [ ### Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando do macOS ](#awscli-install-osx-path) + [ ### Desinstalar a AWS CLI usando pip ](#awscli-install-osx-pip-uninstall) ### 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 ``` 1. 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 ``` ### Instalar e atualizar a AWS CLI usando 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 da AWS CLI**, use o seguinte bloco de comandos: ``` $ pip3 install awscli --upgrade --user ``` **Para uma versão específica da 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 ``` 1. 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](#awscli-install-osx-path). ### Adicionar 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. **Example Local de instalação da AWS CLI – macOS com Python 3.6 e `pip` (modo usuário)** ``` ~/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 a aplicação 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` 1. 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. 1. Carregue o perfil atualizado em sua sessão atual. ``` $ source ~/.bash_profile ``` ### Desinstalar a AWS CLI usando pip 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. 1. **(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 *\$1/.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/ ``` ## 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](cli-chap-troubleshooting.md) 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](cli-chap-troubleshooting.md#tshoot-install-not-found), [O comando “`aws --version`” retorna uma versão diferente da que você instalou](cli-chap-troubleshooting.md#tshoot-install-wrong-version) e [O comando “`aws --version`” retorna uma versão após a desinstalação da AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).