**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 e atualização da AWS CLI versão 1 em um ambiente virtual
<a name="install-virtualenv"></a>

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
<a name="install-virtualenv-prereqs"></a>
+ 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
<a name="install-virtualenv-install"></a>

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
<a name="install-virtualenv-tshoot"></a>

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