

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.

# Creación de una AWS ParallelCluster AMI personalizada
<a name="tutorials_02_ami_customization"></a>

**importante**  
No es recomendable crear una AMI personalizada para personalizar AWS ParallelCluster.  
Esto se debe a que, después de crear su propia AMI, ya no recibirá actualizaciones ni correcciones de errores en futuras versiones de AWS ParallelCluster. Además, si crea una AMI personalizada, debe repetir los pasos que utilizó para crear la AMI personalizada con cada nueva AWS ParallelCluster versión.

Antes de seguir leyendo, le recomendamos que consulte primero la sección [Acciones de Bootstrap personalizadas](pre_post_install.md) para determinar si las modificaciones que desea realizar se pueden programar y admitir en futuras AWS ParallelCluster versiones.

Aunque crear una AMI personalizada no es lo ideal (por las razones mencionadas anteriormente), todavía hay situaciones en las que AWS ParallelCluster es necesario crear una AMI personalizada. Este tutorial le guía a través del proceso de creación de una AMI personalizada para estos escenarios.

**nota**  
A partir de AWS ParallelCluster la versión 2.6.1, la mayoría de las recetas de instalación se omiten de forma predeterminada al lanzar nodos. Esto sirve para mejorar los tiempos de inicio. Para ejecutar todas las recetas de instalación para una mejor compatibilidad con versiones anteriores a costa de los tiempos de inicio, añada `"skip_install_recipes" : "no"` a la clave `cluster` en la configuración [`extra_json`](cluster-definition.md#extra-json). Por ejemplo:  

```
extra_json = { "cluster" : { "skip_install_recipes" : "no" } }
```

**Requisitos previos**
+ AWS ParallelCluster [está](install.md) instalado.
+  AWS CLI [está instalado y configurado.](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
+ Tiene un [par de claves EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html).
+ Tiene un rol de IAM con los [permisos](iam.md#example-parallelcluser-policies) necesarios para ejecutar el CLI [`pcluster`](pcluster.md).

## Cómo personalizar la AWS ParallelCluster AMI
<a name="how-to-customize-the-aws-parallelcluster-ami"></a>

Hay tres maneras de usar una AWS ParallelCluster AMI personalizada que se describen en las siguientes secciones. Dos de estos tres métodos requieren que cree una nueva AMI que esté disponible en su Cuenta de AWS. El tercer método (usar una AMI personalizada en tiempo de ejecución) no requiere que se cree nada por adelantado, pero sí añade riesgos a la implementación. Elija el método que mejor se adapte a sus necesidades.

## Modificar una AMI de
<a name="modify-an-aws-parallelcluster-ami"></a>

Este es el método más seguro y recomendado. Como la AWS ParallelCluster AMI básica se actualiza a menudo con nuevas versiones, esta AMI tiene todos los componentes necesarios AWS ParallelCluster para funcionar cuando se instala y configura. Puede comenzar con esto como base.

------
#### [ New EC2 console ]

1. En la lista de AWS ParallelCluster AMI, busque la AMI que corresponda a la específica Región de AWS que utilice. La lista de AMI que elija debe coincidir con la versión AWS ParallelCluster que utilice. Ejecute `pcluster version` para verificar la versión. Para la AWS ParallelCluster versión 2.11.9, vaya a [https://github.com/aws/aws-.txt. parallelcluster/blob/v2.11.9/amis](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/amis.txt) Para seleccionar otra versión, utilice el mismo enlace, pulse el botón **Etiqueta: 2.11.9**, seleccione la pestaña **Etiquetas** y a continuación, seleccione la versión adecuada.

1. Inicie sesión en la consola Amazon EC2 Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. En el **panel de Amazon EC2**, elija **Lanzar instancia**.

1. En **Imágenes de aplicaciones y sistemas operativos**, selecciona **Explorar más AMIs** AMIs, ve a **Comunidad** e Región de AWS introduce tu ID de AWS ParallelCluster AMI en el cuadro de búsqueda.

1. **Seleccione** la AMI, elija el **tipo de instancia** y las propiedades, seleccione su **Par de claves** y **Lanza instancia**.

1. Inicie sesión en la instancia mediante el usuario del sistema operativo y su clave de SSH. Para obtener más información, vaya a **Instancias**, seleccione la nueva instancia y **Conectar**.

1. Personalice su instancia según sea necesario.

1. Ejecute el siguiente comando para preparar su instancia para la creación de la AMI:

   ```
   sudo /usr/local/sbin/ami_cleanup.sh
   ```

1. Navegue a **Instancias**, elija la nueva instancia, seleccione **Estado de la instancia**, y **Detener instancia**

1. Cree una AMI nueva a partir de la instancia mediante la consola EC2 o AWS CLI [cree](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image.html) una imagen.

**Desde la consola EC2**

   1. Elija **Instances** (Instancia[s]) en el panel de navegación.

   1. Elija la instancia que creó y modificó.

   1. Elija **Acciones**, **Imágenes y plantillas** y a continuación **Crear imagen**.

   1. Elija **Create Image (Crear imagen)**.

1. Escriba el ID de AMI en el campo [custom\$1ami](cluster-definition.md#custom-ami-section) de la configuración del clúster.

------
#### [ Old EC2 console ]

1. En la lista de AWS ParallelCluster AMI, busque la AMI que corresponda a la específica Región de AWS que utilice. La lista de AMI que elija debe coincidir con la versión AWS ParallelCluster que utilice. Ejecute `pcluster version` para verificar la versión. Para la AWS ParallelCluster versión 2.11.9, vaya a [https://github.com/aws/aws-.txt. parallelcluster/blob/v2.11.9/amis](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/amis.txt) Para seleccionar otra versión, utilice el mismo enlace, pulse el botón **Etiqueta: 2.11.9**, seleccione la pestaña **Etiquetas** y a continuación, seleccione la versión adecuada.

1. Inicie sesión en la consola Amazon EC2 Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. En el **panel de Amazon EC2**, elija **Lanzar instancia**.

1. Elija **Comunidad AMIs**, busque el ID de AWS ParallelCluster AMI y **selecciónelo**.

1. Elija el tipo de instancia y seleccione **Siguiente: configurar los detalles de la instancia** o **Revisar y lanzar** para lanzar la instancia.

1. Elija **Lanzar**, seleccione su **par de claves** y **lance las instancias**.

1. Inicie sesión en la instancia mediante el usuario del sistema operativo y su clave de SSH. Para obtener más información, vaya a **Instancias**, seleccione la nueva instancia y **Conectar**.

1. Personalice su instancia según sea necesario.

1. Ejecute el siguiente comando para preparar su instancia para la creación de la AMI:

   ```
   sudo /usr/local/sbin/ami_cleanup.sh
   ```

1. Navegue a **Instancias**, elija la nueva instancia, seleccione **Estado de la instancia**, y **Detener**

1. Cree una AMI nueva a partir de la instancia mediante la consola EC2 o AWS CLI [cree](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image.html) una imagen.

**Desde la consola EC2**

   1. Elija **Instances** (Instancia[s]) en el panel de navegación.

   1. Elija la instancia que creó y modificó.

   1. Elija **Acciones**, **Imagen** y a continuación, **Crear imagen**.

   1. Elija **Create Image (Crear imagen)**.

1. Escriba el ID de AMI en el campo [custom\$1ami](cluster-definition.md#custom-ami-section) de la configuración del clúster.

------

## Cree una AWS ParallelCluster AMI personalizada
<a name="build-a-custom-aws-parallelcluster-ami"></a>

Si ya tiene instalados una AMI personalizada y software, puede aplicar en ellos los cambios que AWS ParallelCluster necesita.

1. Instale lo siguiente en su sistema local, junto con la AWS ParallelCluster CLI:
   + Packer: obtenga la versión más reciente para su sistema operativo en el [sitio web de Packer](https://developer.hashicorp.com/packer/downloads) e instálela. La versión debe ser al menos 1.4.0, pero se recomienda utilizar la versión más reciente. Compruebe que el `packer` comando esté disponible en su RUTA.
**nota**  
Antes de AWS ParallelCluster la versión 2.8.0, era necesario usar [Berkshelf](https://github.com/berkshelf/berkshelf) (que se instala mediante el uso`gem install berkshelf`). `pcluster createami`

1. Configure sus Cuenta de AWS credenciales para que Packer pueda realizar llamadas a las operaciones de la AWS API en su nombre. El conjunto mínimo de permisos necesarios para que Packer funcione se documenta en la sección [Tarea de IAM o rol de instancia](https://developer.hashicorp.com/packer/plugins/builders/amazon#iam-task-or-instance-role) del tema *Amazon AMI Builder* de la documentación de Packer.

1. Utilice el comando `createami` de la AWS ParallelCluster CLI para crear una AWS ParallelCluster AMI a partir de la que proporciona como base:

   ```
   pcluster createami --ami-id <BASE_AMI> --os <BASE_AMI_OS>
   ```
**importante**  
No debe usar una AWS ParallelCluster AMI de un clúster en ejecución como *<BASE\$1AMI>* para el `createami` comando. De lo contrario, el comando falla.

   Para otros parámetros, consulte [`pcluster createami`](pcluster.createami.md).

1. El comando del paso 4 ejecuta Packer, el cual a su vez ejecuta siguiente específicamente:

   1. Lanza una instancia mediante la AMI Base que se le ha proporcionado.

   1. Aplica el AWS ParallelCluster manual de cocina a la instancia para instalar el software correspondiente y realizar otras tareas de configuración necesarias.

   1. Detiene la instancia.

   1. Crea una nueva AMI a partir de la instancia.

   1. Termina la instancia después de crear la AMI.

   1. Produce la cadena del nuevo ID de AMI que debe utilizarse para crear el clúster.

1. Para crear el clúster, especifique el ID de AMI en el campo [custom\$1ami](cluster-definition.md#custom-ami-section) de la configuración del clúster.

**nota**  
El tipo de instancia que se utiliza para crear una AWS ParallelCluster AMI personalizada es`t2.xlarge`. Este tipo de instancia no cumple los requisitos para la capa AWS gratuita, por lo que se le cobrará por cualquier instancia que se cree al crear esta AMI.

## Uso de una AMI personalizada en tiempo de ejecución
<a name="use-a-custom-ami-at-runtime"></a>

**aviso**  
Para evitar el riesgo de usar una AMI que no sea compatible AWS ParallelCluster, le recomendamos que evite usar este método.  
Cuando los nodos de cómputo se lanzan con la posibilidad de que no se AMIs hayan probado en tiempo de ejecución, las incompatibilidades con la instalación en tiempo de ejecución AWS ParallelCluster del software necesario pueden AWS ParallelCluster provocar que deje de funcionar.

Si no quieres crear nada por adelantado, puedes usar tu AMI y crear una AWS ParallelCluster a partir de esa AMI.

Con este método, se tarda más en AWS ParallelCluster crearla, ya que debe estar instalado todo el software que se necesita para crear el clúster. AWS ParallelCluster Además, el escalado vertical también lleva más tiempo.
+ Escriba el ID de AMI en el campo [custom\$1ami](cluster-definition.md#custom-ami-section) de la configuración del clúster.