Sección Build

(Obligatorio) Especifica la configuración en la que se generará la imagen.

Build:
  Imds:
    ImdsSupport: string
  InstanceType: string
  SubnetId: string
  ParentImage: string
  Iam:
    InstanceRole: string
    InstanceProfile: string
    CleanupLambdaRole: string
    AdditionalIamPolicies:
      - Policy: string
    PermissionsBoundary: string
  Components:
    - Type: string
      Value: string
  Tags:
    - Key: string
      Value: string
  SecurityGroupIds:
    - string
  UpdateOsPackages:
    Enabled: boolean

Propiedades de Build

InstanceType(Obligatorio,String)

Especifica el tipo de instancia de la instancia utilizada para crear la imagen.

SubnetId(Opcional,String)

Especifica el ID de una subred existente en la que aprovisionar la instancia para crear la imagen. La subred proporcionada requiere acceso a Internet.

aviso

pcluster build-imageusa la VPC predeterminada. Si se ha eliminado la VPC predeterminada, quizás mediante nuestraAWS Control Tower zona deAWS destino, se debe especificar el ID de subred.

ParentImage(Obligatorio,String)

Especifica la imagen base. La imagen principal puede ser una AMI que no sea de laAWS ParallelCluster AMI o unaAWS ParallelCluster AMI oficial para la misma versión. No puedes usar una AMIAWS ParallelCluster oficial o personalizada de una versión diferente deAWS ParallelCluster. El formato debe ser el ARN de una imagenarn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion o un ID de AMIami-12345678.

SecurityGroupIds(Opcional,[String])

Especifica la lista de ID del grupo de seguridad para la imagen.

Imds

Propiedades de Imds

(Opcional) Especifica la configuración del servicio de metadatos de instancias (IMDS) de ImageBuilder compilación y prueba de EC2.

Imds:
  ImdsSupport: string

ImdsSupport(Opcional,String)

Especifica qué versiones de IMDS se admiten en las instancias de ImageBuilder compilación y prueba de EC2. Los valores admitidos son v2.0 y v1.0. El valor predeterminado es v1.0.

SiImdsSupport se establece env1.0, se admiten tanto IMDSv1 como IMDSv2.

SiImdsSupport se establece env2.0, solo se admite IMDSv2.

Para obtener más información, consulte Usar IMDSv2 en la Guía del usuario de EC2 para instancias de Linux.

Política de actualización: si se cambia esta configuración, la actualización no está permitida.

nota

En una fecha future, el valorImdsSupport predeterminado cambiará dev1.0 av2.0. Le recomendamos que configureImdsSupportv2.0 y sustituya IMDSv1 por IMDSv2 en sus llamadas a acciones personalizadas.

La Support con Imds/ImdsSupportse añade conAWS ParallelCluster la versión 3.3.0.

Iam

Propiedades de Iam

(Opcional) Especifica los recursos de IAM para la creación de la imagen.

Iam:
  InstanceRole: string
  InstanceProfile: string
  CleanupLambdaRole: string
  AdditionalIamPolicies:
    - Policy: string
  PermissionsBoundary: string

InstanceProfile(Opcional,String)

Especifica un perfil de instancia para anular el perfil de instancia predeterminado de la instancia de EC2 Image Builder. InstanceProfileInstanceRoleyAdditionalIamPolicies no se pueden especificar juntos. El formato es el siguiente arn:Partition:iam::Account:instance-profile/InstanceProfileName.

InstanceRole(Opcional,String)

Especifica un rol de instancia para anular el rol de instancia predeterminado para la instancia de EC2 Image Builder. InstanceProfileInstanceRoleyAdditionalIamPolicies no se pueden especificar juntos. El formato es el siguiente arn:Partition:iam::Account:role/RoleName.

CleanupLambdaRole(Opcional,String)

El ARN del rol de IAM que se utilizará para laAWS Lambda función que respalda el recursoAWS CloudFormation personalizado que elimina los artefactos de compilación al finalizar la compilación. Lambda debe configurarse como el principal al que se le permite asumir el rol. El formato es el siguiente arn:Partition:iam::Account:role/RoleName.

AdditionalIamPolicies(Opcional)

Especifica políticas de IAM adicionales para adjuntarlas a la instancia de EC2 Image Builder utilizada para producir la AMI personalizada.

AdditionalIamPolicies:
  - Policy: string

Policy(Opcional,[String])

Lista de políticas de IAM. El formato es el siguiente arn:Partition:iam::Account:policy/PolicyName.

PermissionsBoundary(Opcional,String)

El ARN de la política de IAM que se utilizará como límite de permisos para todos los roles creados porAWS ParallelCluster. Para obtener más información sobre los límites de los permisos de IAM, consulte los límites de permisos para las entidades de IAM en la Guía del usuario de IAM. El formato es el siguiente arn:Partition:iam::Account:policy/PolicyName.

Components

Propiedades de Components

(Opcional) Especifica ImageBuilder los componentes de EC2 que se utilizarán durante el proceso de creación de la AMI, además de los que proporciona de forma predeterminadaAWS ParallelCluster. Estos componentes se pueden utilizar para personalizar el proceso de creación de la AMI. Para obtener más información, consulte AWS ParallelClusterpersonalizada AMI.

Components:
  - Type: string
    Value: string

Type(Opcional,String)

Especifica el tipo del par tipo-valor del componente. El tipo puede serarn oscript.

Value(Opcional,String)

Especifica el valor del par tipo-valor del componente. Cuando el tipo esarn, es el ARN de un componente de EC2 Image Builder. Cuando se escribescript, se trata del enlace https o s3 que apunta al script que se utilizará al crear el componente EC2 Image Builder.

Tags

Propiedades de Tags

(Opcional) Especifica la lista de etiquetas que se configurarán en los recursos utilizados para crear la AMI.

Tags:
  - Key: string
    Value: string

Key(Opcional,String)

Define el nombre de la etiqueta.

Value(Opcional,String)

Define el valor de la etiqueta.

UpdateOsPackages

Propiedades de UpdateOsPackages

(Opcional) Especifica si el sistema operativo se actualiza antes de instalar el paqueteAWS ParallelCluster de software.

UpdateOsPackages:
  Enabled: boolean

Enabled(Opcional,Boolean)

Sitrue, el sistema operativo se actualiza y se reinicia antes de instalar elAWS ParallelCluster software. El valor predeterminado es false.

nota

CuandoUpdateOsPackages está habilitada, se actualizan todos los paquetes del sistema operativo disponibles, incluido el núcleo. Como cliente, usted es responsable de verificar que la actualización sea compatible con las dependencias de la AMI que no están incluidas en la actualización.

Por ejemplo, supongamos que está creando una AMI para laAWS ParallelCluster versión X.0 que viene incluida con la versión Y.0 del núcleo y la versión Z.0 de algún componente. Supongamos que la actualización disponible incluye la versión Y.1 del núcleo actualizada sin actualizaciones del componente Z.0. Antes de activarloUpdateOsPackages, es su responsabilidad comprobar que el componente Z.0 es compatible con el núcleo Y.1.