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

# Instalar AWS ParallelCluster em um ambiente virtual (recomendado)
<a name="install-virtualenv"></a>

Recomendamos que você instale AWS ParallelCluster em um ambiente virtual para evitar conflitos de versão de requisitos com outros `pip` pacotes.

**Pré-requisitos**
+ Verifique se `pip` e Python estão instalados. Recomendamos `pip3` e Python 3 versão 3.8. Se você estiver usando o Python 2, use `pip` em vez de `pip3` e `virtualenv` em vez de `venv`.

**Para instalar AWS ParallelCluster em um ambiente virtual**

1. Se o `virtualenv` não estiver instalado, instale o `virtualenv` usando `pip3`. Se `python3 -m virtualenv help` exibir informações de ajuda, vá para a etapa 2.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ python3 -m pip install --upgrade pip
   $ python3 -m pip install --user --upgrade virtualenv
   ```

   Execute `exit` para sair da janela do terminal atual e abrir uma nova janela de terminal para selecionar as alterações no ambiente.

------
#### [ Windows ]

   ```
   C:\>pip3 install --user --upgrade virtualenv
   ```

   Execute `exit` para sair do prompt de comando atual e abra um novo prompt de comando para selecionar alterações no ambiente.

------

1. Crie um ambiente virtual e nomeie-o.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ python3 -m virtualenv ~/apc-ve
   ```

   Como alternativa, você pode usar a opção `-p` para especificar uma versão do Python.

   ```
   $ python3  -m virtualenv -p $(which python3) ~/apc-ve
   ```

------
#### [ Windows ]

   ```
   C:\>virtualenv %USERPROFILE%\apc-ve
   ```

------

1. <a name="activate-virtual-environment"></a>Ative seu novo ambiente virtual.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ source ~/apc-ve/bin/activate
   ```

------
#### [ Windows ]

   ```
   C:\>%USERPROFILE%\apc-ve\Scripts\activate
   ```

------

1. Instale AWS ParallelCluster em seu ambiente virtual.

------
#### [ Linux, macOS, or Unix ]

   ```
   (apc-ve)~$ python3 -m pip install --upgrade "aws-parallelcluster<3.0"
   ```

------
#### [ Windows ]

   ```
   (apc-ve) C:\>pip3 install --upgrade "aws-parallelcluster<3.0"
   ```

------

1. Verifique se AWS ParallelCluster está instalado corretamente.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ pcluster version
   2.11.9
   ```

------
#### [ Windows ]

   ```
   (apc-ve) C:\>pcluster version
   2.11.9
   ```

------

Use o comando `deactivate` para sair do ambiente virtual. Toda vez que iniciar uma sessão, é necessário [reativar o ambiente](#activate-virtual-environment).

Para atualizar para a versão mais recente do AWS ParallelCluster, execute o comando de instalação novamente.

------
#### [ Linux, macOS, or Unix ]

```
(apc-ve)~$ python3 -m pip install --upgrade "aws-parallelcluster<3.0"
```

------
#### [ Windows ]

```
(apc-ve) C:\>pip3 install --upgrade "aws-parallelcluster<3.0"
```

------