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 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) 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 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\$1 instalado, recomendamos usar o comando **pip3**. ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## Etapas a serem realizadas após a instalação 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 + [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) # Instalar AWS ParallelCluster em um ambiente virtual (recomendado) 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. 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" ``` ------ # Instale AWS ParallelCluster no Linux Você pode instalar AWS ParallelCluster e suas dependências na maioria das distribuições Linux usando um gerenciador `pip` de pacotes para Python. Primeiro, determine se o Python e o `pip` estão instalados: 1. Para determinar se a sua versão do Linux inclui Python e `pip`, execute `pip --version`. ``` $ pip --version ``` Se você `pip` instalou, vá para o tópico [Instalar AWS ParallelCluster com pip.](install.md) Caso contrário, continue na Etapa 2. 1. Para determinar se o Python está instalado, execute `python --version`. ``` $ python --version ``` [Se você tiver o Python 3 versão 3.6\$1 ou o Python 2 versão 2.7 instalado, vá para o tópico Instalar com pip. AWS ParallelCluster](install.md) Caso contrário, [instale o Python](install-linux-python.md) e retorne a este procedimento para instalar o `pip`. 1. Instale o `pip` usando o script fornecido pela *Python Packaging Authority*. 1. Use o comando `curl` a seguir para baixar o script de instalação. ``` $ curl -O https://bootstrap.pypa.io/get-pip.py ``` 1. Execute o script com Python para fazer download e instalar a versão mais recente do `pip` e de outros pacotes de suporte necessários. ``` $ python get-pip.py --user ``` or ``` $ python3 get-pip.py --user ``` Quando você inclui a chave `--user`, o script instala o `pip` no caminho `~/.local/bin`. 1. Para garantir que a pasta que contém `pip` faça parte da variável `PATH`, faça o seguinte: 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 `basename $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 ``` O comando de exportação insere o caminho, que é `~/.local/bin` neste exemplo, na frente da variável `PATH` existente. 1. Para colocar essas alterações em vigor, recarregue o perfil em sua sessão atual. ``` $ source ~/.bash_profile ``` 1. Verifique se o `pip` está instalado corretamente. ``` $ pip3 --version pip 21.3.1 from ~/.local/lib/python3.6/site-packages (python 3.6) ``` **Topics** + [Instale AWS ParallelCluster com `pip`](#install-linux-with-pip) + [Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando](#install-linux-path) + [Instalar o Python no Linux](install-linux-python.md) ## Instale AWS ParallelCluster com `pip` Use `pip` para instalar AWS ParallelCluster. ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` Ao usar a chave `--user`, o `pip` instala o AWS ParallelCluster em `~/.local/bin`. Verifique se AWS ParallelCluster está instalado corretamente. ``` $ pcluster version 2.11.9 ``` Para atualizar para a versão mais recente, execute o comando de instalação novamente. ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` ## Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando Após a instalação com o `pip`, talvez seja necessário adicionar o executável `pcluster` à variável de ambiente `PATH` do seu sistema operacional. Para verificar a pasta na qual `pip` está instalado AWS ParallelCluster, execute o comando a seguir. ``` $ which pcluster /home/username/.local/bin/pcluster ``` Se você omitiu a `--user` opção ao instalar AWS ParallelCluster, o executável pode estar na `bin` pasta da instalação do Python. Se você não souber onde o Python está instalado, execute este comando. ``` $ which python /usr/local/bin/python ``` Observe que a saída pode ser o caminho para um symlink, não para o executável em si. Para ver onde o symlink aponta, execute `ls -al`. ``` $ ls -al $(which python) /usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6 ``` Se essa for a mesma pasta que você adicionou ao caminho na etapa 3 em [Instalando AWS ParallelCluster](install.md), a instalação estará concluída. Caso contrário, será necessário realizar as etapas 3a a 3c novamente, incluindo essa pasta adicional ao caminho. # Instalar o Python no Linux Se sua distribuição não veio com o Python ou veio com uma versão anterior, instale o Python antes de instalar e. `pip` AWS ParallelCluster **Para instalar Python 3 no Linux** 1. Verifique se o Python já está instalado. ``` $ python3 --version ``` or ``` $ python --version ``` **nota** Se sua distribuição do Linux acompanha Python, poderá ser necessário instalar o pacote de desenvolvedor Python. O pacote de desenvolvedor inclui os cabeçalhos e as bibliotecas que são necessárias para compilar extensões e instalar o AWS ParallelCluster. Use o gerenciador de pacotes para instalar o pacote de desenvolvedor. Geralmente é chamado de `python-dev` ou `python-devel`. 1. Se Python 2.7 ou posterior não estiver instalado, instale Python com o gerenciador de pacote de distribuição. O comando e o nome do pacote varia de: + No derivados do Debian, como Ubuntu, use `apt`. ``` $ sudo apt-get install python3 ``` + No Red Hat e derivados, use `yum`. ``` $ sudo yum install python3 ``` + No SUSE e derivados, use o `zypper`. ``` $ sudo zypper install python3 ``` 1. Para verificar se o Python foi instalado corretamente, abra um prompt de comando ou shell e execute o comando a seguir. ``` $ python3 --version Python 3.8.11 ``` # Instale AWS ParallelCluster no macOS **Topics** + [Pré-requisitos](#install-bundle-macos-os-prereq) + [Instale AWS ParallelCluster no macOS usando pip](#install-macos-pip) + [Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando](#install-macos-path) ## Pré-requisitos + Python 3 versão 3.7\$1 ou Python 2 versão 2.7 Verifique a instalação do Python. ``` $ python --version ``` Se o Python ainda não foi instalado no computador ou se você deseja instalar uma versão diferente do Python, siga o procedimento em [Instale AWS ParallelCluster no Linux](install-linux.md). ## Instale AWS ParallelCluster no macOS usando pip Você também pode usar `pip` diretamente para instalar AWS ParallelCluster. Se você não tem o `pip`, siga as instruções no [tópico de instalação](install.md) principal. Execute o `pip3 --version` para ver se a sua versão do macOS já inclui o Python e o `pip3`. ``` $ pip3 --version ``` **Para instalar AWS ParallelCluster no macOS** 1. Faça download e instale a versão mais recente do Python da [página de download](https://www.python.org/downloads/mac-osx/) em [Python.org](https://www.python.org). 1. Faça download e execute o script de instalação `pip3` fornecido pela Python Packaging Authority. ``` $ curl -O https://bootstrap.pypa.io/get-pip.py $ python3 get-pip.py --user ``` 1. Use o recém-instalado `pip3` para instalar AWS ParallelCluster. Se você usar o Python versão 3\$1, recomendamos usar o comando `pip3`. ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` 1. Verifique se AWS ParallelCluster está instalado corretamente. ``` $ pcluster version 2.11.9 ``` Se o programa não for encontrado, [adicione-o ao caminho da linha de comando](#install-macos-path). Para atualizar para a versão mais recente, execute o comando de instalação novamente. ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando Após a instalação com o `pip`, talvez seja necessário adicionar o programa `pcluster` à variável de ambiente `PATH` do seu sistema operacional. A localização do programa depende de onde o Python está instalado. **Example AWS ParallelCluster local de instalação - macOS com Python 3.6 e (modo de usuário) `pip`** ``` ~/Library/Python/3.6/bin ``` Substitua a versão do Python que você tem pela versão no exemplo anterior. Se você não souber onde o Python está instalado, execute `which python`. ``` $ which python3 /usr/local/bin/python3 ``` A saída pode ser o caminho para um symlink, e não o caminho para programa real. Execute `ls -al` para saber para onde ele aponta. ``` $ ls -al /usr/local/bin/python3 lrwxr-xr-x 1 username admin 36 Mar 12 12:47 /usr/local/bin/python3 -> ../Cellar/python/3.6.8/bin/python3 ``` O `pip` instala programas na mesma pasta que contém a aplicação Python. Adicione esta pasta à variável `PATH`. **Para modificar a variável `PATH` (Linux, Unix ou macOS)** 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 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 em sua sessão atual. ``` $ source ~/.bash_profile ``` # Instalar AWS ParallelCluster no Windows Você pode instalar AWS ParallelCluster no Windows usando`pip`, que é um gerenciador de pacotes para Python. Caso já tenha `pip`, siga as instruções no [tópico de instalação](install.md) principal. **Topics** + [Instale AWS ParallelCluster usando Python e `pip` no Windows](#install-windows-pip) + [Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando](#install-windows-path) ## Instale AWS ParallelCluster usando Python e `pip` no Windows O Python Software Foundation fornece instaladores para Windows que incluem `pip`. **Para instalar o Python e o `pip` (Windows)** 1. Faça download do instalador do Python Windows x86-64 na [página de downloads](https://www.python.org/downloads/windows/) do [Python.org](https://www.python.org). 1. Execute o instalador. 1. Escolha **Add Python 3 to PATH (Adicionar Python 3 ao PATH)**. 1. Escolha **Instalar agora**. O instalador instala o Python em sua pasta de usuário e adiciona suas pastas do programa ao caminho do usuário. **Para instalar AWS ParallelCluster com `pip3` (Windows)** Se você usar o Python versão 3\$1, recomendamos usar o comando `pip3`. 1. Abra o **Command Prompt (Prompt de comando)** no menu **Start (Iniciar)**. 1. Use os seguintes comandos para verificar se o Python e o `pip` estão instalados corretamente. ``` C:\>py --version Python 3.8.11 C:\>pip3 --version pip 21.3.1 from c:\python38\lib\site-packages\pip (python 3.8) ``` 1. Instale AWS ParallelCluster usando`pip`. ``` C:\>pip3 install "aws-parallelcluster<3.0" ``` 1. Verifique se AWS ParallelCluster está instalado corretamente. ``` C:\>pcluster version 2.11.9 ``` Para atualizar para a versão mais recente, execute o comando de instalação novamente. ``` C:\>pip3 install --user --upgrade "aws-parallelcluster<3.0" ``` ## Adicione o AWS ParallelCluster executável ao seu caminho de linha de comando Depois de instalar AWS ParallelCluster com`pip`, adicione o `pcluster` programa à variável de `PATH` ambiente do seu sistema operacional. É possível encontrar onde o programa `pcluster` está instalado executando o comando a seguir. ``` C:\>where pcluster C:\Python38\Scripts\pcluster.exe ``` Se esse comando não retornar nenhum resultado, você deverá adicionar o caminho manualmente. Use a linha de comando ou o Windows Explorer para descobrir onde ele está instalado no computador. Os caminhos típicos incluem: + **Python 3 e `pip3`** – `C:\Python38\Scripts\` + **Python 3 e `pip3` --opção do usuário** – `%APPDATA%\Python\Python38\Scripts` **nota** Os nomes de pasta que incluem os números de versão podem variar. Os exemplos anteriores mostram Python38. Substitua conforme necessário com o número da versão que você está usando. **Para modificar sua variável PATH (Windows)** 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 ao campo **Variable value (Valor da variável)**. Por exemplo: ***C:\$1new\$1path*** 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.