

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.

# AWS ParallelCluster Personalización de AMI
<a name="custom-ami-v3"></a>

Hay situaciones en las que AWS ParallelCluster es necesario crear una AMI personalizada para. En esta sección se explica qué se debe tener en cuenta al crear una AWS ParallelCluster AMI personalizada.

Puede crear una AWS ParallelCluster AMI personalizada mediante uno de los métodos siguientes:

1. Cree un [archivo de configuración de imagen de compilación](image-builder-configuration-file-v3.md) y a continuación, utilice la CLI `pcluster` para crear la imagen con Generador de imágenes de EC2. Este proceso es automatizado, repetible y admite la supervisión. Para obtener más información, consulte los comandos de imagen [`pcluster`](pcluster-v3.md).

1. Cree una instancia a partir de una AWS ParallelCluster AMI, inicie sesión en ella y realice las modificaciones manuales. Por último, utilice Amazon EC2 para crear una AMI nueva a partir de la instancia modificada. Este proceso lleva menos tiempo. Sin embargo, no es automático ni repetible, y no admite el uso de los comandos de monitoreo de imágenes CLI `pcluster`.

Para obtener más información acerca de estos métodos, consulte [Creación de una AWS ParallelCluster AMI personalizada](building-custom-ami-v3.md).

## AWS ParallelCluster Consideraciones sobre la personalización de la AMI
<a name="custom-ami-considerations-v3"></a>

Independientemente de cómo cree la imagen personalizada, le recomendamos que realice pruebas de validación preliminares e incluya disposiciones para supervisar el estado de la imagen que se está creando.

Para crear una AMI personalizada mediante `pcluster`, debe crear un [archivo de configuración de generador de imágenes](image-builder-configuration-file-v3.md) con una sección de [`Build`](Build-v3.md) y [`Image`](Image-v3.md#Image-v3.properties) que [Generador de imágenes de EC2](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html) utiliza para crear la imagen personalizada. En la sección `Build` se especifica lo que Generador de imágenes necesita para crear la imagen. Esto incluye la [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage) (imagen base) y [`Components`](Build-v3.md#Build-v3-Components). Un [componente de Generador de imágenes](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-component-manager.html) define una secuencia de pasos necesarios para personalizar una instancia antes de crear una imagen o para probar una instancia lanzada por la imagen creada. Para obtener más información, consulte [Creación de un componente personalizado con Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component.html) en la Guía del *usuario de EC2 Image Builder*.

Cuando se le llama desde pcluster [`build-image`](pcluster.build-image-v3.md)para crear una imagen personalizada, Image Builder utiliza la configuración de la imagen de compilación con el AWS ParallelCluster libro de cocina para iniciar su. AWS ParallelCluster [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage) Generador de imágenes descarga componentes, ejecuta las fases de compilación y validación, crea la AMI, lanza una instancia desde la AMI y ejecuta las pruebas. Cuando se complete el proceso, Generador de imágenes generará una nueva imagen o un mensaje de parada.

## Realice pruebas de validación de componentes personalizadas
<a name="custom-ami-validation-v3"></a>

Antes de incluir un componente de Generador de imágenes en una configuración, pruébelo y valídelo mediante uno de los métodos siguientes. Como el proceso de Generador de imágenes puede tardar hasta 1 hora, le recomendamos que pruebe los componentes con antelación. Esto puede ahorrarle una cantidad considerable de tiempo.

**Caso de script**  
Pruebe el script en una instancia en ejecución, fuera del proceso de creación de la imagen, y compruebe que el script sale con el código de salida 0.

**Nombre de recurso de Amazon (ARN)**  
Pruebe el documento del componente en una instancia en ejecución, fuera del proceso de creación de la imagen. Para obtener una lista de requisitos, consulte [Administrador de componentes](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-component-manager.html) en la *Guía del usuario de Generador de imágenes*.

**Tras la validación correcta, añada el componente a la configuración de la imagen de compilación**  
Tras comprobar que el componente personalizado funciona, agréguelo al [archivo de configuración de la imagen de compilación](image-builder-configuration-file-v3.md).

## Supervise el proceso de Generador de imágenes con comandos `pcluster` para facilitar la depuración
<a name="custom-ami-monitor-v3"></a>

[`describe-image`](pcluster.describe-image-v3.md)

Utilice este comando para supervisar el estado de la imagen de compilación.

[`list-image-log-streams`](pcluster.list-image-log-streams-v3.md)

Use este comando para obtener los flujos IDs de registro con los que puede recuperar los eventos de registro. [`get-image-log-events`](pcluster.get-image-log-events-v3.md)

[`get-image-log-events`](pcluster.get-image-log-events-v3.md)

Utilice este comando para obtener el flujo de registro de los eventos del proceso de creación de imágenes.

Por ejemplo, puede crear eventos de imagen mediante el siguiente comando:

```
$ watch -n 1 'pcluster get-image-log-events -i {{<image-id>}} \
        --log-stream-name/1 {{<pcluster-version>}} \
        --query "events[*].message" | tail -n 50'
```

[`get-image-stack-events`](pcluster.get-image-stack-events-v3.md)

Utilice este comando para recuperar los eventos de la pila que crea Generador de imágenes.

[`export-image-logs`](pcluster.export-image-logs-v3.md)

Utilice este comando para guardar registros de imágenes.

Para obtener más información sobre AWS ParallelCluster los registros y Amazon CloudWatch, consulte [Amazon CloudWatch Logs crea registros de imágenes](cloudwatch-logs-v3.md#cloudwatch-logs-build-images) y[CloudWatch Panel de control de Amazon](cloudwatch-dashboard-v3.md).

## Otras consideraciones
<a name="custom-ami-other-v3"></a>

**Nuevos AWS ParallelCluster lanzamientos y personalizados AMIs**  
Si crea una AMI personalizada, debe repetir los pasos que utilizó para crear la AMI personalizada con cada nueva versión de AWS ParallelCluster .

**Acciones de arranque personalizadas**  
Revise la [Acciones de arranque personalizadas](custom-bootstrap-actions-v3.md) sección para determinar si las modificaciones que desee realizar se pueden programar y admitir en futuras AWS ParallelCluster versiones.

**Utilización de opciones personalizadas AMIs**  
Puede especificar la personalización AMIs en la configuración del clúster en las [`CustomAmi`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Image-CustomAmi)secciones [`Image`[`Scheduling`[`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)](Scheduling-v3.md)](Image-v3.md)/[`CustomAmi`](Image-v3.md#yaml-Image-CustomAmi)y [`Name`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Name)//- [`Image`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Image)/.  
Para solucionar problemas de las advertencias de validación de AMI personalizadas, consulte [Solución de problemas con las AMI de](troubleshooting-v3-custom-amis.md).