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

# Instalando AWS ParallelCluster
<a name="install"></a>

AWS ParallelCluster é distribuído como um pacote Python e é instalado usando o gerenciador `pip` de pacotes Python. Para obter mais informações sobre como instalar pacotes Python, consulte [Instalar pacotes](https://packaging.python.org/tutorials/installing-packages/) no *Guia do usuário de pacotes do Python*.

**Formas de instalar AWS ParallelCluster:**
+ [Usando um ambiente virtual (recomendado)](#install-tool-venv)
+ [Como usar o `pip`](#install-tool-pip)

Você pode encontrar o número da versão da CLI mais recente na [página de lançamentos](https://github.com/aws/aws-parallelcluster/releases) em. GitHub

Neste guia, os exemplos de comando pressupõem que você tenha Python v3 instalado. Os exemplos do comando `pip` usam a versão `pip3`.

## Instalação AWS ParallelCluster em um ambiente virtual (recomendado)
<a name="install-tool-venv"></a>

Recomendamos que você instale AWS ParallelCluster em um ambiente virtual. Se você encontrar problemas ao tentar instalar AWS ParallelCluster com`pip3`, poderá [instalar AWS ParallelCluster em um ambiente virtual](install-virtualenv.md) para isolar a ferramenta e suas dependências. Ou você pode usar uma versão do Python diferente da que você normalmente usa.

## Instalando AWS ParallelCluster em um ambiente não virtual usando pip
<a name="install-tool-pip"></a>

O principal método de distribuição para AWS ParallelCluster Linux, Windows e macOS é`pip`, que é um gerenciador de pacotes para Python. Ele fornece uma maneira de instalar, atualizar e remover pacotes Python e suas dependências.

**AWS ParallelCluster Versão atual**  
AWS ParallelCluster é atualizado regularmente. Para determinar se você tem a versão mais recente, consulte a [página de lançamentos em GitHub](https://github.com/aws/aws-parallelcluster/releases).

Se você já tem `pip` uma versão compatível do Python, pode instalar AWS ParallelCluster usando o comando a seguir. Se você tiver o Python versão 3\+ instalado, recomendamos usar o comando **pip3**.

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

## Etapas a serem realizadas após a instalação
<a name="install-post"></a>

Depois da instalação AWS ParallelCluster, talvez seja necessário adicionar o caminho do arquivo executável à sua `PATH` variável. Para instruções específicas da plataforma, consulte os seguintes tópicos:
+ **Linux**: [Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando](install-linux.md#install-linux-path)
+ **macOS**: [Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando](install-macos.md#install-macos-path)
+ **Windows**: [Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando](install-windows.md#install-windows-path)

Você pode verificar se AWS ParallelCluster está instalado corretamente executando`pcluster version`.

```
$ pcluster version
2.11.9
```

AWS ParallelCluster é atualizado regularmente. Para atualizar para a versão mais recente do AWS ParallelCluster, execute o comando de instalação novamente. Para obter detalhes sobre a versão mais recente do AWS ParallelCluster, consulte as [notas AWS ParallelCluster de lançamento](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/CHANGELOG.md).

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

Para desinstalar AWS ParallelCluster, use`pip uninstall`.

```
$ pip3 uninstall "aws-parallelcluster<3.0"
```

Se não tem o Python nem o `pip`, use o procedimento para o seu ambiente.

## Instruções detalhadas para cada ambiente
<a name="install-sections"></a>
+ [Instalar AWS ParallelCluster em um ambiente virtual (recomendado)](install-virtualenv.md)
+ [Instale AWS ParallelCluster no Linux](install-linux.md)
+ [Instale AWS ParallelCluster no macOS](install-macos.md)
+ [Instalar AWS ParallelCluster no Windows](install-windows.md)