**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/). # Instalar, atualizar e desinstalar a AWS CLI Este tópico fornece links para instalar, atualizar e desinstalar a versão original da AWS Command Line Interface(AWS CLI). A AWS CLI versão 1 atualmente é compatível, mas novos recursos adicionados à AWS CLI versão 2 não podem ser adicionados à AWS CLI versão 1. Para usar esses recursos, é necessário instalar a AWS CLI versão 2. Para obter mais informações sobre como instalar a versão 2, consulte [Instalar a AWS CLI versão 2](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html). **Topics** + [ ## Requisitos da versão do Python ](#cli-chap-install-python) + [Amazon Linux](install-linux-al2017.md) + [Linux](install-linux.md) + [macOS](install-macos.md) + [Windows](install-windows.md) + [Virtualenv](install-virtualenv.md) ## Requisitos da versão do Python A AWS CLI versão 1 é criada com o SDK for Python e, portanto, requer a instalação de uma versão compatível do 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\$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 | Para obter informações sobre as versões mais recentes da AWS CLI, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no GitHub. # Instalação, atualização e desinstalação da AWS CLI versão 1 no Amazon Linux A AWS CLI versão 1 está pré-instalada no Amazon Linux e no Amazon Linux 2. Verifique a versão atualmente instalada usando o comando a seguir. ``` $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6 ``` Dependendo de quando você criou sua instância do Amazon Linux, a AWS CLI versão 1 é pré-instalada usando um dos seguintes gerenciadores de pacotes: + [pip](#install-amazon-linux-pip) + [yum](#install-amazon-linux-yum) ## 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](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 usando pip A maioria das instâncias do Amazon Linux usa pip para pré-instalar a AWS CLI versão 1. ### Instalar ou atualizar a AWS CLI versão 1 no Amazon Linux usando pip Para instalar a versão mais recente da AWS CLI versão 1 para o usuário atual, use as instruções a seguir. 1. Se você tiver o Python versão 3 ou posterior instalado, recomendamos usar o `pip3`. Use `pip3 install` para instalar ou atualizar para a versão mais recente da AWS CLI versão 1. Se você executar o comando em um [ambiente virtual Python (venv)](https://docs.python.org/3/library/venv.html), não será necessário usar a opção `--user`. ``` $ pip3 install --upgrade --user awscli ``` 1. Verifique se a pasta que contém `aws` faz parte da 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 final do script de perfil que é semelhante ao exemplo a seguir. ``` export PATH=$HOME/.local/bin:$PATH ``` Esse comando insere o caminho `$HOME/.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. Para verificar se você está executando a nova versão, use o comando `aws --version`. ``` $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6 ``` ### Desinstalar a AWS CLI versão 1 usando pip Se precisar desinstalar a AWS CLI, use `pip uninstall`. ``` $ pip3 uninstall awscli ``` ## Instalar, atualizar ou desinstalar usando yum A maioria das instâncias do Amazon Linux usa yum para pré-instalar a AWS CLI versão 1. ### Instalar ou atualizar a AWS CLI versão 1 no Amazon Linux usando yum Para instalar a versão mais recente da AWS CLI versão 1 disponível no Amazon Linux, execute o comando a seguir. ``` $ sudo yum install awscli ``` Para atualizar para versão mais recente da AWS CLI versão 1 disponível no Amazon Linux, execute o comando a seguir. ``` $ sudo yum update awscli ``` Para verificar se você está executando a versão mais recente, use o comando `aws --version`. ``` $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6 ``` ### Desinstalar a AWS CLI versão 1 usando yum Para desinstalar a AWS CLI, use `yum remove`. ``` $ sudo yum remove awscli ``` ## 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). # 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. **Topics** + [ ## Pré-requisitos ](#install-linux-prereqs) + [ ## Instalar e desinstalar a AWS CLI versão 1 no Linux usando o instalador empacotado ](#install-linux-bundled) + [ ## Instalar e desinstalar a AWS CLI versão 1 usando pip ](#install-linux-pip) + [ ## Instalar e desinstalar a AWS CLI versão 1 usando Snapcraft ](#install-linux-snap) + [ ## Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando ](#install-linux-path) + [ ## Solução de problemas de erros de instalação e desinstalação da AWS CLI ](#install-linux-tshoot) ## 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](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 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. **Topics** + [ ### Instalar a AWS CLI versão 1 usando o instalador empacotado com `sudo` ](#install-linux-bundled-sudo) + [ ### Instalar a AWS CLI versão 1 usando o instalador empacotado sem `sudo` ](#install-linux-bundled-no-sudo) + [ ### Desinstalar o instalador empacotado da AWS CLI versão 1 ](#install-linux-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 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** 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` 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 ``` 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`. 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 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 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.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. 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** 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 os arquivos do pacote usando `unzip`. 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 na pasta especificada. ``` $ ./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 o diretório da AWS CLI versão 1 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. 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 ``` 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 -r ~/.aws/ ``` ## Instalar e desinstalar a AWS CLI versão 1 usando pip **Topics** + [ ### Instalar o pip ](#install-linux-pip-pip) + [ ### Instalar e atualizar a AWS CLI versão 1 usando pip ](#install-linux-awscli) + [ ### Desinstalar a AWS CLI usando pip ](#post-install-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 no diretório 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 ``` 1. Verifique se o diretório que contém o `pip` 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. Para verificar se `pip` ou `pip3` está instalado corretamente, execute o comando a seguir. ``` $ pip3 --version pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7) ``` ### Instalar e atualizar a AWS CLI versão 1 usando pip 1. Use o comando `pip` ou `pip3` para instalar ou atualizar a AWS CLI. Se você usar o Python versão 3 ou posterior, recomendamos usar o comando `pip3`. O switch `--user`, `pip` instala 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 --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 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 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 -r ~/.aws/ ``` ## Instalar e desinstalar a AWS CLI versão 1 usando Snapcraft **Topics** + [ ### Instalar o snap ](#install-linux-snap-install) + [ ### Instalar e atualizar a AWS CLI versão 1 usando snap ](#install-linux-snap-update) + [ ### Desinstalar a AWS CLI usando snap ](#install-linux-snap-uninstall) ### 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`. 1. Instale o Snapcraft em sua plataforma. Para obter informações sobre como instalar o Snapcraft, consulte [Instalar o daemon](https://snapcraft.io/docs/installing-snapd) na *Documentação do Snap*. 1. Reinicie o sistema para que suas variáveis `PATH` sejam atualizadas corretamente. Se você estiver tendo problemas de instalação, siga as etapas em [Corrigir problemas comuns](https://snapcraft.io/docs/fix-common-issues) na *documentação do snap*. 1. Para verificar se o `snap` está instalado corretamente, execute o seguinte comando. ``` $ snap version ``` ### Instalar e atualizar a AWS CLI versão 1 usando snap 1. Execute o seguinte comando `snap install` da AWS CLI versão 1. ``` $ snap install aws-cli --channel=v1/stable --classic ``` Dependendo de suas permissões, pode ser necessário adicionar `sudo` ao seu comando. ``` $ sudo snap install aws-cli --channel=v1/stable --classic ``` 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 a AWS CLI usando snap 1. Se você instalou a AWS CLI versão 1 usando `snap`, também será necessário desinstalá-la usando `snap`. ``` $ snap remove aws-cli ``` 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 você tiver permissões de gravação nesse diretório, não será necessário usar `sudo`. ``` $ 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`** 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 ``` ## 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). # 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). # Instalação, atualização e desinstalação da AWS CLI versão 1 no Windows Você pode instalar a versão 1 da AWS Command Line Interface (AWS CLI) no Windows usando um instalador independente (recomendado) ou o `pip`, que é um gerenciador de pacotes para Python. Não inclua o símbolo de prompt (`C:\>`) ao digitar um comando. Eles são incluídos nas listas do programa para diferenciar comandos que você digita da saída retornada pela AWS CLI. O restante desse guia usa o símbolo de prompt genérico (`$`), exceto nos casos em que um comando é específico do Windows. **Topics** + [ ## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando o instalador MSI ](#msi-on-windows) + [ ## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando Python e pip no Windows ](#awscli-install-windows-pip) + [ ## Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando ](#awscli-install-windows-path) + [ ## Solução de problemas de erros de instalação e desinstalação da AWS CLI ](#awscli-install-windows-tshoot) ## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando o instalador MSI A AWS CLI versão 1 é compatível com o Windows XP ou posterior. Para usuários do Windows, o pacote de instalação MSI oferece uma maneira familiar e conveniente de instalar a AWS CLI versão 1 sem necessitar de nenhum outro pré-requisito. ### Instalar e atualizar a AWS CLI versão 1 usando o instalador MSI Confira a página de [Liberações](https://github.com/aws/aws-cli/releases) no GitHub para ver quando a versão mais recente foi lançada. Quando novas atualizações forem lançadas, você deverá repetir o processo de instalação para instalar a versão mais recente da AWS CLI versão 1. 1. Baixe o instalador MSI apropriado: + Instalador MSI da AWS CLI para Windows (64 bits): [https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi) + Instalador MSI da AWS CLI para Windows (32 bits): [https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi) + Arquivo de configuração combinado da AWS CLI para Windows: [ https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe) (inclui os instaladores MSI de 32 bits e de 64 bits e instala automaticamente a versão correta) 1. Execute o instalador MSI baixado ou o arquivo de configuração. 1. Siga as instruções da tela. Por padrão, a AWS CLI versão 1 é instalada em `C:\Program Files\Amazon\AWSCLI` (versão de 64 bits) ou em `C:\Program Files (x86)\Amazon\AWSCLI` (versão de 32 bits). 1. Para confirmar a instalação, use o comando `aws --version` em um prompt de comando (abra o menu **Start (Iniciar)** e pesquise `cmd` para iniciar um prompt de comando). ``` C:\> aws --version aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6 ``` Se o Windows não conseguir localizar o programa, talvez seja necessário fechar e abrir o prompt de comando novamente para atualizar o caminho ou [adicionar o diretório de instalação à variável de ambiente PATH](#awscli-install-windows-path) manualmente. ### Desinstalar a AWS CLI versão 1 Para usar as instruções de desinstalação a seguir, é necessário ter instalado a AWS CLI versão 1 com o instalador MSI ou com o arquivo de configuração. 1. Abra **Programas e Recursos** seguindo um destes procedimentos: + Abra o **Painel de Controle** e selecione **Programas e Recursos**. + Abra um prompt de comando e execute o comando a seguir. ``` C:\> appwiz.cpl ``` 1. Selecione a entrada denominada **AWS Command Line Interface** e escolha **Uninstall (Desinstalar)** para executar o desinstalador. 1. Confirme que deseja desinstalar a AWS CLI. 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 *%UserProfile%\$1.aws*. ``` $ rmdir %UserProfile%\.aws ``` ## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando Python e pip no Windows O Python Software Foundation fornece instaladores para Windows que incluem `pip`. ### 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](https://wiki.python.org/moin/BeginnersGuide/Download) no *Beginner's Guide* do Python. ### Instalar e atualizar a AWS CLI versão 1 usando pip 1. Para instalar a AWS CLI versão 1, use o comando `pip3` (se você usar o Python versão 3 ou posterior) ou o comando `pip`. **Para a versão mais recente da AWS CLI**, use o seguinte bloco de comandos: ``` C:\> pip3 install awscli --upgrade --user ``` **Para uma versão específica da AWS CLI**, acrescente símbolo de menor que `<` 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: ``` C:\> pip3 install awscli<1.16.312 --upgrade --user ``` 1. Verifique se a AWS CLI versão 1 está instalada corretamente. Se não houver resposta, consulte a seção [Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando](#awscli-install-windows-path). ``` C:\> aws --version aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6 ``` ### Desinstalar a AWS CLI versão 1 usando pip 1. Se você instalou a AWS CLI versão 1 usando `pip`, também será necessário desinstalá-la usando `pip`. ``` C:\> 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. ``` C:\> 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 *%UserProfile%\$1.aws*. ``` $ rmdir %UserProfile%\.aws ``` ## Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando Após a instalação da AWS CLI versão 1 com o `pip`, adicione o programa `aws` à variável de ambiente `PATH` do seu sistema operacional. Com uma instalação MSI, isso deve acontecer automaticamente. Mas se o comando `aws` não for executado após a instalação, talvez seja necessário configurá-lo manualmente. 1. Use o comando `where` para encontrar o local do arquivo `aws`. Por padrão, o comando `where` mostra onde um programa especificado é encontrado no `PATH` do sistema. ``` C:\> where aws ``` Os caminhos que aparecem dependem da plataforma e do método utilizado para instalar a AWS CLI. Os nomes de pasta que incluem os números de versão podem variar. Esses exemplos refletem o uso do Python versão 3.7. Substitua a versão pelo número de versão que você está usando, conforme necessário. Os caminhos típicos incluem o seguinte: + **Python 3 e `pip3`** – `C:\Program Files\Python37\Scripts\` + **Python 3 e opção --user do `pip3` em versões anteriores do Windows** – `%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts` + **Python 3 e `pip3`: opção do usuário no Windows 10**: `%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts` + **Instalador MSI (64 bits)** – `C:\Program Files\Amazon\AWSCLI\bin` + **Instalador MSI (32 bits)** – `C:\Program Files (x86)\Amazon\AWSCLI\bin` Use as etapas a seguir levando em conta se um caminho de arquivo é retornado. ------ #### [ A file path is returned ] ``` C:\> where aws C:\Program Files\Amazon\AWSCLI\bin\aws.exe ``` É possível encontrar onde o programa `aws` está instalado executando o comando a seguir. ``` C:\> where c:\ aws C:\Program Files\Python37\Scripts\aws ``` ------ #### [ A file path is NOT returned ] Se o comando `where` retornar o erro a seguir, ele não estará no `PATH` do sistema e você não poderá executá-lo inserindo seu nome. ``` C:\> where c:\ aws INFO: Could not find files for the given pattern(s). ``` Nesse caso, execute o comando `where` com o parâmetro `/R path` para instrui-lo a pesquisar todas as pastas e adicione o caminho manualmente. Use a linha de comando ou o Explorador de Arquivos para descobrir onde ele está instalado no computador. ``` C:\> where /R c:\ aws c:\Program Files\Amazon\AWSCLI\bin\aws.exe c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd ... ``` ------ 1. Pressione a tecla Windows e digite **environment variables**. 1. Escolha **Edit environment variables for your account ** (Editar variáveis de ambiente para sua conta). 1. Selecione **PATH** e, em seguida, **Edit** (Editar). 1. Adicione o caminho encontrado no campo **Variable value** (Valor da variável). Por exemplo, ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***. 1. Escolha **OK** duas vezes para aplicar as novas configurações. 1. Feche todos os prompts de comando em execução e abra novamente a janela do prompt de comando. ## 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). # Instalação e atualização da AWS CLI versão 1 em um ambiente virtual Instale a versão 1 da `pip` (AWS Command Line Interface) em um ambiente virtual para evitar conflitos de versão de requisito com outros pacotes AWS CLI. **Topics** + [ ## Pré-requisitos ](#install-virtualenv-prereqs) + [ ## Instalar e atualizar a AWS CLI versão 1 em um ambiente virtual ](#install-virtualenv-install) + [ ## Solução de problemas de erros de instalação e desinstalação da AWS CLI ](#install-virtualenv-tshoot) ## Pré-requisitos + Python 3.8 ou posterior. 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** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/cli/v1/userguide/install-virtualenv.html) + `pip` ou `pip3` está instalado. ## Instalar e atualizar a AWS CLI versão 1 em um ambiente virtual 1. Instale `virtualenv` usando o `pip`. ``` $ pip install --user virtualenv ``` 1. Crie um ambiente virtual e nomeie-o. ``` $ virtualenv ~/cli-ve ``` Como alternativa, você pode usar a opção `-p` para especificar uma versão do Python que não seja a padrão. ``` $ virtualenv -p /usr/bin/python37 ~/cli-ve ``` 1. Ative seu novo ambiente virtual. **Linux ou macOS** ``` $ source ~/cli-ve/bin/activate ``` **Windows** ``` $ %USERPROFILE%\cli-ve\Scripts\activate ``` O prompt mudará para mostrar que o ambiente virtual está ativo. ``` (cli-ve)~$ ``` 1. Instale ou atualize a AWS CLI versão 1 em seu ambiente virtual. ``` (cli-ve)~$ pip install --upgrade awscli ``` 1. Verifique se a AWS CLI versão 1 está instalada 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 ``` 1. Use o comando `deactivate` para sair do ambiente virtual. Sempre que você iniciar uma nova sessão, deverá ativar novamente o ambiente. ## 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).