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-v3-virtual-environment"></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**
+ AWS ParallelCluster requer Python 3.7 ou posterior. Se você ainda não o tiver instalado, [baixe uma versão compatível](https://www.python.org/downloads/) para sua plataforma em [python.org](https://www.python.org/).

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

   ```
   $ 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.

1. Crie um ambiente virtual e nomeie-o.

   ```
   $ 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
   ```

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

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

1. Instale AWS ParallelCluster em seu ambiente virtual.

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

1. Instale o Node Version Manager e a versão mais recente do Node.js do Long-Term Support (LTS). AWS Cloud Development Kit (AWS CDK) requer Node.js CloudFormation para geração de modelos.
**nota**  
Se a instalação do Node.js não estiver funcionando na sua plataforma, você poderá instalar uma versão LTS antes da versão mais recente do LTS. Para obter mais informações, consulte o [cronograma de lançamento do Node.js](https://github.com/nodejs/release#release-schedule) e os [pré-requisitos do AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/work-with.html#work-with-prerequisites).  
Exemplo de comando de instalação do Node.js:  

   ```
   $  nvm install --lts=Hydrogen
   ```

   ```
   $ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash
   $ chmod ug+x ~/.nvm/nvm.sh
   $ source ~/.nvm/nvm.sh
   $ nvm install --lts
   $ node --version
   ```

1. Verifique se AWS ParallelCluster está instalado corretamente.

   ```
   $ pcluster version
   {
     "version": "3.15.0"
   }
   ```

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

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

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