Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Instalación AWS ParallelCluster AWS ParallelCluster se distribuye como un paquete de Python y se instala mediante `pip` el administrador de paquetes de Python. Para obtener más información acerca de la instalación de paquetes de Python, consulte el tema sobre la [instalación de paquetes](https://packaging.python.org/tutorials/installing-packages/) en la *Guía del usuario de paquetes de Python*. **Formas de instalación AWS ParallelCluster:** + [Mediante un entorno virtual (recomendado)](#install-tool-venv) + [Uso de `pip`](#install-tool-pip) Puede encontrar el número de versión de la CLI más reciente en la [página de versiones de GitHub](https://github.com/aws/aws-parallelcluster/releases). En esta guía, los comandos de ejemplo dan por hecho que tiene Python v3 instalado. Los comandos de ejemplo `pip` utilizan la versión `pip3`. ## Instalación AWS ParallelCluster en un entorno virtual (recomendado) Se recomienda realizar la instalación AWS ParallelCluster en un entorno virtual. Si tiene problemas al intentar realizar la instalación AWS ParallelCluster con`pip3`, puede [instalarla AWS ParallelCluster en un entorno virtual](install-virtualenv.md) para aislar la herramienta y sus dependencias. También puede utilizar una versión de Python diferente de la que usa habitualmente. ## Instalación AWS ParallelCluster en un entorno no virtual mediante pip El método de distribución principal para AWS ParallelCluster Linux, Windows y macOS es `pip` un administrador de paquetes para Python. Proporciona una manera de instalar, actualizar y eliminar paquetes de Python y sus dependencias. **AWS ParallelCluster Versión actual** AWS ParallelCluster se actualiza periódicamente. Para determinar si dispone de la última versión, consulte la [página de versiones en GitHub](https://github.com/aws/aws-parallelcluster/releases). Si ya tiene `pip` una versión compatible de Python, puede instalarla AWS ParallelCluster mediante el siguiente comando. Si tiene instalada la versión 3 o superior de Python, recomendamos que utilice el comando **pip3**. ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## Pasos que seguir después de la instalación Tras la instalación AWS ParallelCluster, es posible que tenga que añadir la ruta del archivo ejecutable a la `PATH` variable. Si desea obtener instrucciones específicas de las distintas plataformas, consulte estos temas: + **Linux**: [Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos](install-linux.md#install-linux-path) + **macOS**: [Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos](install-macos.md#install-macos-path) + **Windows**: [Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos](install-windows.md#install-windows-path) Puede comprobar que se AWS ParallelCluster ha instalado correctamente ejecutando`pcluster version`. ``` $ pcluster version 2.11.9 ``` AWS ParallelCluster se actualiza periódicamente. Para actualizar a la versión más reciente de AWS ParallelCluster, vuelva a ejecutar el comando de instalación. Para obtener más información sobre la última versión de AWS ParallelCluster, consulte las [notas AWS ParallelCluster de la versión](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/CHANGELOG.md). ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` Para AWS ParallelCluster desinstalarla, utilice`pip uninstall`. ``` $ pip3 uninstall "aws-parallelcluster<3.0" ``` Si no dispone de Python ni `pip`, utilice el procedimiento para su entorno. ## Instrucciones detalladas para cada entorno + [Instalar AWS ParallelCluster en un entorno virtual (recomendado)](install-virtualenv.md) + [Instálelo AWS ParallelCluster en Linux](install-linux.md) + [Instalar AWS ParallelCluster en macOS](install-macos.md) + [Instalar AWS ParallelCluster en Windows](install-windows.md) # Instalar AWS ParallelCluster en un entorno virtual (recomendado) Se recomienda instalarlo AWS ParallelCluster en un entorno virtual para evitar conflictos entre las versiones obligatorias y otros `pip` paquetes. **Requisitos previos** + Compruebe que `pip` y Python están instalados. Recomendamos `pip3` y Python 3 versión 3.6. Si utiliza Python 2, utilice `pip` en lugar de `pip3` y `virtualenv` en lugar de `venv`. **Para instalarlo AWS ParallelCluster en un entorno virtual** 1. Si `virtualenv` no está instalado, instale `virtualenv` mediante `pip3`. Si `python3 -m virtualenv help` muestra información de ayuda, vaya al paso 2. ------ #### [ Linux, macOS, or Unix ] ``` $ python3 -m pip install --upgrade pip $ python3 -m pip install --user --upgrade virtualenv ``` Ejecute `exit` para salir de la ventana de terminal actual y abrir una nueva para detectar los cambios del entorno. ------ #### [ Windows ] ``` C:\>pip3 install --user --upgrade virtualenv ``` Ejecute `exit` para salir del símbolo del sistema actual y abrir uno nuevo para detectar los cambios del entorno. ------ 1. Cree un entorno virtual y asígnele un nombre. ------ #### [ Linux, macOS, or Unix ] ``` $ python3 -m virtualenv ~/apc-ve ``` También puede usar la opción `-p` para especificar una versión específica de Python. ``` $ python3 -m virtualenv -p $(which python3) ~/apc-ve ``` ------ #### [ Windows ] ``` C:\>virtualenv %USERPROFILE%\apc-ve ``` ------ 1. Active el entorno virtual nuevo. ------ #### [ Linux, macOS, or Unix ] ``` $ source ~/apc-ve/bin/activate ``` ------ #### [ Windows ] ``` C:\>%USERPROFILE%\apc-ve\Scripts\activate ``` ------ 1. Instálelo AWS ParallelCluster en su entorno 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. Compruebe que AWS ParallelCluster está instalado correctamente. ------ #### [ Linux, macOS, or Unix ] ``` $ pcluster version 2.11.9 ``` ------ #### [ Windows ] ``` (apc-ve) C:\>pcluster version 2.11.9 ``` ------ Puedes utilizar el comando `deactivate` para salir del entorno virtual. Cada vez que inicie una sesión, debe [activar el entorno de nuevo](#activate-virtual-environment). Para actualizar a la versión más reciente de AWS ParallelCluster, vuelva a ejecutar el comando de instalación. ------ #### [ 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" ``` ------ # Instálelo AWS ParallelCluster en Linux Puede instalar AWS ParallelCluster y sus dependencias en la mayoría de las distribuciones de Linux mediante `pip` un administrador de paquetes para Python. En primer lugar, determine si Python y `pip` están instalados: 1. Para determinar si su versión de Linux incluye Python y `pip`, ejecute `pip --version`. ``` $ pip --version ``` Si lo ha `pip` instalado, vaya al tema [Instalar AWS ParallelCluster con pip](install.md). De lo contrario, prosiga con el paso 2. 1. Para determinar si Python está instalado, ejecute `python --version`. ``` $ python --version ``` Si tiene instalada la versión 3.6\$1 de Python 3 o la versión 2.7 de Python 2, vaya al tema [Instalar AWS ParallelCluster con pip](install.md). De lo contrario, [instale Python](install-linux-python.md) y, a continuación, vuelva a este procedimiento para instalar `pip`. 1. Instale `pip` con el script proporcionado por *Python Packaging Authority*. 1. Utilice el comando `curl` para descargar el script de instalación. ``` $ curl -O https://bootstrap.pypa.io/get-pip.py ``` 1. Ejecute el script con Python para descargar e instalar la versión más reciente de `pip` y otros paquetes de soporte necesarios. ``` $ python get-pip.py --user ``` o ``` $ python3 get-pip.py --user ``` Cuando se incluye el modificador `--user`, el script instala `pip` en la ruta `~/.local/bin`. 1. Para asegurarse de que la carpeta que contiene `pip` forma parte de la variable `PATH`, haga lo siguiente: 1. Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `basename $SHELL`. ``` $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads ``` + **Bash**: `.bash_profile`, `.profile` o `.bash_login`. + **Zsh**: `.zshrc` + **Tcsh**: `.tcshrc`, `.cshrc` o `.login`. 1. Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo. ``` export PATH=~/.local/bin:$PATH ``` El comando de exportación inserta la ruta, que es `~/.local/bin` en este ejemplo, delante de la variable `PATH` existente. 1. Para que estos cambios surtan efecto, vuelva a cargar el perfil en la sesión actual. ``` $ source ~/.bash_profile ``` 1. Compruebe que `pip` está instalado correctamente. ``` $ pip3 --version pip 21.3.1 from ~/.local/lib/python3.6/site-packages (python 3.6) ``` **Topics** + [ ## Instálalo con AWS ParallelCluster `pip` ](#install-linux-with-pip) + [ ## Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos ](#install-linux-path) + [ # Instalación de Python en Linux ](install-linux-python.md) ## Instálalo con AWS ParallelCluster `pip` Se usa `pip` para instalar AWS ParallelCluster. ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` Cuando se utiliza el modificador `--user`, `pip` instala AWS ParallelCluster en `~/.local/bin`. Compruebe que se AWS ParallelCluster ha instalado correctamente. ``` $ pcluster version 2.11.9 ``` Para actualizar a la versión más reciente, ejecute el comando de instalación de nuevo. ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` ## Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos Después de realizar la instalación con `pip`, es posible que necesite añadir el archivo ejecutable `pcluster` a la variable de entorno `PATH` del sistema operativo. Para comprobar la carpeta en la que `pip` se instaló AWS ParallelCluster, ejecute el siguiente comando. ``` $ which pcluster /home/username/.local/bin/pcluster ``` Si omitió el `--user` modificador al realizar la instalación AWS ParallelCluster, es posible que el ejecutable esté en la `bin` carpeta de su instalación de Python. Si no sabe dónde se ha instalado Python, ejecute este comando. ``` $ which python /usr/local/bin/python ``` Tenga en cuenta que la salida puede ser la ruta a un symlink, no al archivo ejecutable real. Para ver adónde apunta el symlink, ejecute `ls -al`. ``` $ ls -al $(which python) /usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6 ``` Si esta es la misma carpeta que ha añadido a la ruta en el paso 3 en [Instalación AWS ParallelCluster](install.md), ya ha terminado con la instalación. De lo contrario, siga de nuevo esos mismos pasos del 3a al 3c, añadiendo esta carpeta adicional a la ruta. # Instalación de Python en Linux Si su distribución no venía con Python o venía con una versión anterior, instale Python antes de instalar `pip` y AWS ParallelCluster. **Para instalar Python 3 en Linux** 1. Compruebe si Python ya está instalado. ``` $ python3 --version ``` o ``` $ python --version ``` **nota** Si su distribución de Linux incluye Python, es posible que tenga que instalar el paquete de desarrollador de Python. En el paquete de desarrollador se incluyen los encabezados y las bibliotecas que son necesarios para compilar extensiones e instalar AWS ParallelCluster. Utilice el administrador de paquetes para instalar el paquete de desarrollador. Suele llamarse `python-dev` o `python-devel`. 1. Si no está instalado Python 2.7 o una versión posterior, instale Python con el administrador de paquetes de su distribución. El comando y el nombre del paquete varían: + En derivados de Debian, como por ejemplo Ubuntu, use `apt`. ``` $ sudo apt-get install python3 ``` + En Red Hat y sus derivados, use `yum`. ``` $ sudo yum install python3 ``` + En SUSE y sus derivados, use `zypper`. ``` $ sudo zypper install python3 ``` 1. Para verificar que Python está instalado correctamente, abra un símbolo del sistema o shell y ejecute el siguiente comando. ``` $ python3 --version Python 3.8.11 ``` # Instalar AWS ParallelCluster en macOS **Topics** + [ ## Requisitos previos ](#install-bundle-macos-os-prereq) + [ ## Instalar AWS ParallelCluster en macOS mediante pip ](#install-macos-pip) + [ ## Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos ](#install-macos-path) ## Requisitos previos + Python 3 versión 3.7\$1 o Python 2 versión 2.7 Compruebe su instalación de Python. ``` $ python --version ``` Si aún no se ha instalado Python en el equipo o quiere instalar otra versión distinta, siga el procedimiento detallado en [Instálelo AWS ParallelCluster en Linux](install-linux.md). ## Instalar AWS ParallelCluster en macOS mediante pip También se puede utilizar `pip` directamente para instalar AWS ParallelCluster. Si no tiene `pip`, siga las instrucciones del [tema de instalación](install.md) principal. Ejecute `pip3 --version` para saber si su versión de macOS ya incluye Python y `pip3`. ``` $ pip3 --version ``` **Para instalar AWS ParallelCluster en macOS** 1. Descargue e instale la última versión de Python de la [página de descargas](https://www.python.org/downloads/mac-osx/) de [Python.org](https://www.python.org). 1. Descargue y ejecute el script de instalación de `pip3` proporcionado por Python Packaging Authority. ``` $ curl -O https://bootstrap.pypa.io/get-pip.py $ python3 get-pip.py --user ``` 1. Usa la que acabas de instalar `pip3` para realizar la instalación AWS ParallelCluster. Si utiliza la versión 3 o superior de Python, recomendamos que utilice el comando `pip3`. ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` 1. Compruebe que AWS ParallelCluster está instalado correctamente. ``` $ pcluster version 2.11.9 ``` Si no se encuentra el programa, [añádalo a la ruta de la línea de comandos](#install-macos-path). Para actualizar a la versión más reciente, ejecute el comando de instalación de nuevo. ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos Después de realizar la instalación con `pip`, es posible que necesite añadir el programa `pcluster` a la variable de entorno `PATH` del sistema operativo. La ubicación del programa depende de dónde se haya instalado Python. **Example AWS ParallelCluster ubicación de instalación: macOS con Python 3.6 y `pip` (modo usuario)** ``` ~/Library/Python/3.6/bin ``` Sustituya la versión de Python que tiene con la versión del ejemplo anterior. Si no sabe dónde se ha instalado Python, ejecute `which python`. ``` $ which python3 /usr/local/bin/python3 ``` La salida puede ser la ruta a un symlink, no la ruta al programa real. Ejecute `ls -al` para ver adónde apunta. ``` $ 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 ``` `pip` instala los programas en la misma carpeta que contiene la aplicación de Python. Añada esta carpeta a la variable `PATH`. **Para modificar la variable `PATH` (Linux, Unix o macOS):** 1. Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`. ``` $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads ``` + **Bash**: `.bash_profile`, `.profile` o `.bash_login`. + **Zsh**: `.zshrc` + **Tcsh**: `.tcshrc`, `.cshrc` o `.login`. 1. Añada un comando de exportación al script de su perfil. ``` export PATH=~/.local/bin:$PATH ``` Este comando añade una ruta, `~/.local/bin` en este ejemplo, a la variable `PATH` actual. 1. Cargue el perfil en su sesión actual. ``` $ source ~/.bash_profile ``` # Instalar AWS ParallelCluster en Windows Puede instalarlo AWS ParallelCluster en Windows utilizando`pip`, que es un administrador de paquetes para Python. Si ya tiene `pip`, siga las instrucciones del [tema de instalación](install.md) principal. **Topics** + [ ## Instalación AWS ParallelCluster mediante Python y `pip` en Windows ](#install-windows-pip) + [ ## Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos ](#install-windows-path) ## Instalación AWS ParallelCluster mediante Python y `pip` en Windows La Python Software Foundation ofrece instaladores para Windows que incluyen `pip`. **Para instalar Python 3.6 y `pip` (Windows)** 1. Descargue el instalador de Python para Windows x86-64 desde la [página de descargas](https://www.python.org/downloads/windows/) de [Python.org](https://www.python.org). 1. Ejecute el instalador. 1. Elija **Add Python 3 to PATH (Añadir Python3 a PATH)**. 1. Seleccione **Install Now (Instalar ahora)**. El instalador instala Python en la carpeta del usuario y añade sus carpetas de programas a la ruta del usuario. **Para instalar AWS ParallelCluster con `pip3` (Windows)** Si usa la versión 3 o superior de Python, recomendamos que utilice el comando `pip3`. 1. Abra el **Command Prompt (Símbolo del sistema)** desde el menú **Start (Inicio)**. 1. Utilice los siguientes comandos para comprobar que tanto Python como `pip` estén instalados correctamente. ``` 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. Instalar AWS ParallelCluster usando`pip`. ``` C:\>pip3 install "aws-parallelcluster<3.0" ``` 1. Compruebe que AWS ParallelCluster está instalado correctamente. ``` C:\>pcluster version 2.11.9 ``` Para actualizar a la versión más reciente, ejecute el comando de instalación de nuevo. ``` C:\>pip3 install --user --upgrade "aws-parallelcluster<3.0" ``` ## Agregue el AWS ParallelCluster ejecutable a la ruta de la línea de comandos Tras instalarlo AWS ParallelCluster con`pip`, añada el `pcluster` programa a la variable de `PATH` entorno del sistema operativo. Para encontrar dónde está instalado el programa de `pcluster`, ejecute el siguiente comando. ``` C:\>where pcluster C:\Python38\Scripts\pcluster.exe ``` Si ese comando no devuelve ningún resultado, debe añadir la ruta manualmente. Utilice la línea de comandos o el Explorador de Windows para averiguar dónde está instalado en el equipo. Las rutas típicas incluyen: + **Python 3 y`pip3`**: `C:\Python38\Scripts\` + **Python 3 y opción `pip3` --user —** `%APPDATA%\Python\Python38\Scripts` **nota** Los nombres de carpeta que incluyen los números de versión puede variar. En los ejemplos anteriores se muestra Python38. Sustitúyalos según sea necesario por el número de versión que está utilizando. **Para modificar su variable PATH (Windows)** 1. Pulse la tecla de Windows y escriba **environment variables**. 1. Elija **Edit environment variables for your account (Edición de las variables de entorno de esta cuenta)**. 1. Elija **PATH** y, a continuación, **Edit (Edición de)**. 1. Añada la ruta al campo **Variable value (Valor de variable)**. Por ejemplo: ***C:\$1new\$1path*** 1. Elija **OK (Aceptar)** dos veces para aplicar la nueva configuración. 1. Cierre los símbolos del sistema en ejecución y vuelva a abrir la ventana de símbolo del sistema.