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. # Cree archivos de configuración de imágenes AWS ParallelCluster la versión 3 usa archivos YAML 1.1 para los parámetros de configuración de la imagen de compilación. Confirme que la indentación es correcta para reducir los errores de configuración. Para obtener más información, consulte la especificación de YAML 1.1 en. [https://yaml.org/spec/1.1/](https://yaml.org/spec/1.1/) Estos archivos de configuración se utilizan para definir cómo se crean las AWS ParallelCluster AMI personalizadas mediante EC2 Image Builder. Los procesos de creación de AMI personalizados se activan mediante el [`pcluster build-image`](pcluster.build-image-v3.md) comando. Para ver algunos ejemplos de archivos de configuración, consulte [https://github.com/aws/aws- parallelcluster/tree/release-3.0/cli/tests/pcluster/schemas/test\$1imagebuilder\$1schema/test \$1imagebuilder\$1schema](https://github.com/aws/aws-parallelcluster/tree/release-3.0/cli/tests/pcluster/schemas/test_imagebuilder_schema/test_imagebuilder_schema). **Topics** + [ ## Cree las propiedades del archivo de configuración de imágenes ](#build-image-v3.properties) + [ # Sección de `Build` ](Build-v3.md) + [ # Sección de `Image` ](build-Image-v3.md) + [ # Sección de `DeploymentSettings` ](DeploymentSettings-build-image-v3.md) ## Cree las propiedades del archivo de configuración de imágenes `Region` (**Opcional**, `String`) Especifica el para la operación. Región de AWS `build-image` Por ejemplo, `us-east-2`. `CustomS3Bucket` (**Opcional**, `String`) Especifica el nombre de un bucket de Amazon S3 que se crea en su AWS cuenta para almacenar los recursos que utiliza el proceso de creación de la AMI personalizada y para exportar los registros. La información utilizada por la imagen se encuentra en el depósito personalizado para la configuración de la imagen. AWS ParallelCluster mantiene un bucket de Amazon S3 en cada AWS región en la que cree los clústeres. De forma predeterminada, estos buckets de Amazon S3 se llaman `parallelcluster-hash-v1-DO-NOT-DELETE`. # Sección de `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 Installation: NvidiaSoftware: Enabled: boolean LustreClient: Enabled: boolean ``` ## Propiedades de `Build` `InstanceType` (**Requerido**, `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 se va a aprovisionar la instancia para generar la imagen. La subred proporcionada requiere acceso a Internet. Tenga en cuenta que es posible que tenga que [modificar los atributos de dirección IP de la subred](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html) si se produce un error en la compilación. `pcluster build-image` utiliza la VPC predeterminada. Si se ha eliminado la VPC predeterminada, tal vez mediante AWS Control Tower una zona de AWS aterrizaje, se debe especificar el ID de subred. Al especificar la SubnetId, se recomienda especificar también la SecurityGroupIds propiedad. Si lo omite SecurityGroupIds , AWS ParallelCluster utilizará los grupos de seguridad predeterminados o se basará en el comportamiento predeterminado de la subred especificada. Al usar ambos, obtiene las siguientes ventajas: + Control detallado: al definir ambas opciones de forma explícita, se asegura de que las instancias lanzadas durante el proceso de creación de la imagen estén ubicadas en la subred correcta y cuenten con el acceso a la red preciso que necesita para los componentes de compilación y cualquier servicio necesario (como el acceso a S3 para los scripts de compilación). + Prácticas recomendadas de seguridad: al definir los grupos de seguridad adecuados, se ayuda a restringir el acceso a la red únicamente a los puertos y servicios necesarios, lo que mejora la seguridad del entorno de compilación. + Evitar posibles problemas: si se basa únicamente en los valores predeterminados, es posible que los grupos de seguridad sean demasiado abiertos o demasiado restrictivos, lo que puede provocar problemas durante el proceso de creación. `ParentImage` (**Requerido**, `String`) Especifica la imagen base. La imagen principal puede ser una AMI que no sea una AWS ParallelCluster AMI o una AWS ParallelCluster AMI oficial de la misma versión. No puedes usar una AMI AWS ParallelCluster oficial o personalizada de una versión diferente de AWS ParallelCluster. El formato debe ser el ARN de una imagen `arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion` o un ID de AMI. `ami-12345678` `SecurityGroupIds` (**Opcional**, `[String]`) Especifica la lista de grupos de seguridad IDs de la imagen. ### `Imds` #### Propiedades de `Imds` **(Opcional)** Especifica la configuración del servicio de metadatos de instancias de ImageBuilder compilación y prueba (IMDS) de Amazon EC2. ``` Imds: ImdsSupport: string ``` `ImdsSupport` (**Opcional**, `String`) Especifica qué versiones de IMDS se admiten en las instancias de compilación y prueba de Amazon ImageBuilder EC2. Los valores admitidos son `v2.0` y `v1.0`. El valor predeterminado es `v2.0`. Si `ImdsSupport` está configurado en`v1.0`, ambas IMDSv2 son IMDSv1 compatibles. Si `ImdsSupport` está establecido en`v2.0`, solo IMDSv2 es compatible. Para obtener más información, consulte [Uso IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) en la *Guía del usuario de Amazon EC2 para instancias de Linux.* [Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3) A partir de AWS ParallelCluster la versión 3.7.0, el valor `ImdsSupport` predeterminado es. `v2.0` Le recomendamos que configure las llamadas `ImdsSupport` a las acciones personalizadas `v2.0` y IMDSv2 las IMDSv1 sustituya por ellas. El soporte para [`Imds`](#Build-v3-Imds)/[`ImdsSupport`](#yaml-build-image-Build-Imds-ImdsSupport)se añade con la AWS ParallelCluster 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 Generador de imágenes de EC2. `InstanceProfile`, `InstanceRole` y `AdditionalIamPolicies` no se pueden especificar juntos. El formato es `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 Generador de imágenes de EC2. `InstanceProfile`, `InstanceRole` y `AdditionalIamPolicies` no se pueden especificar juntos. El formato es `arn:Partition:iam::Account:role/RoleName`. `CleanupLambdaRole` (**Opcional**, `String`) El ARN del rol de IAM que se utilizará para la AWS Lambda función que respalda el recurso CloudFormation personalizado que elimina los artefactos de compilación al finalizar la compilación. Lambda debe configurarse como entidad principal a la que se le permite asumir el rol. El formato es `arn:Partition:iam::Account:role/RoleName`. `AdditionalIamPolicies`**(Opcional)** Especifica políticas de IAM adicionales para adjuntarlas a la instancia de Generador de imágenes de EC2 utilizada para producir la AMI personalizada. ``` AdditionalIamPolicies: - Policy: string ``` `Policy` (**Opcional**, `[String]`) Lista de políticas de IAM. El formato es `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 que se aplica a todos los roles de IAM creados por AWS ParallelCluster. Para obtener más información sobre los límites de los permisos de IAM, consulte [Límites de permisos para las entidades de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) en la *Guía del usuario de IAM*. El formato es `arn:Partition:iam::Account:policy/PolicyName`. ### `Components` #### Propiedades de `Components` (**Opcional**) Especifica ImageBuilder los componentes de Amazon EC2 que se utilizarán durante el proceso de creación de la AMI, además de los que proporciona de forma predeterminada. AWS ParallelCluster Estos componentes se pueden utilizar para personalizar el proceso de creación de la AMI. Para obtener más información, consulte [AWS ParallelCluster Personalización de AMI](custom-ami-v3.md). ``` Components: - Type: string Value: string ``` `Type` (**Opcional**, `String`) Especifica el tipo de par tipo-valor del componente. El tipo puede ser `arn` o. `script` `Value` (**Opcional**, `String`) Especifica el valor del par tipo-valor del componente. Si el tipo es `arn`, es el ARN de un componente de Generador de imágenes de EC2. Si el tipo es`script`, este es el ponente https or s3 link that points to the script to use when you create the EC2 Image Builder com. ### `Tags` #### Propiedades de `Tags` (**Opcional**) Especifica la lista de etiquetas que se van a configurar en los recursos utilizados para crear la AMI. ``` Tags: - Key: string Value: string ``` `Key` (**Opcional**, `String`) Define el nombre del clúster. `Value` (**Opcional**, `String`) Define el valor de etiqueta. ### `UpdateOsPackages` #### Propiedades de `UpdateOsPackages` (**Opcional**) Especifica si el sistema operativo se actualiza antes de instalar la pila de AWS ParallelCluster software. ``` UpdateOsPackages: Enabled: boolean ``` `Enabled` (**Opcional**, `Boolean`) Si`true`, el sistema operativo se actualiza y se reinicia antes de instalar el AWS ParallelCluster software. El valor predeterminado es `false`. Cuando `UpdateOsPackages` está activado, se actualizan todos los paquetes de sistema operativo disponibles, incluido el núcleo. Como cliente, es su responsabilidad comprobar que la actualización es compatible con las dependencias de la AMI que no se incluyen en la actualización. Por ejemplo, supongamos que quiere crear una AMI para la AWS ParallelCluster versión X.0 que se incluye con la versión Y.0 del núcleo y algunos componentes de la versión Z.0. Supongamos que la actualización disponible incluye la versión Y.1 del núcleo actualizada sin actualizaciones del componente Z.0. Antes de activarlo`UpdateOsPackages`, es su responsabilidad comprobar que el componente Z.0 es compatible con el núcleo Y.1. ### `Installation` #### Propiedades de `Installation` **(Opcional)** Especifica el software adicional que se va a instalar en la imagen. ``` Installation: NvidiaSoftware: Enabled: boolean LustreClient: Enabled: boolean ``` `NvidiaSoftware`propiedades (**opcional**) Especifica el software Nvidia que se va a instalar. ``` NvidiaSoftware: Enabled: boolean ``` `Enabled` (**Opcional**, `boolean`) Si`true`, se instalarán el controlador de GPU de Nvidia y CUDA. El valor predeterminado es `false`. `LustreClient`propiedades (**opcional)** Especifica que se instalará el cliente Amazon FSx Lustre. ``` LustreClient: Enabled: boolean ``` `Enabled` (**Opcional**, `boolean`) Si`true`, se instalará el cliente Lustre. El valor predeterminado es `true`. # Sección de `Image` **(Opcional)** Define las propiedades de la imagen para su creación. ``` Image: Name: string RootVolume: Size: integer Encrypted: boolean KmsKeyId: string Tags: - Key: string Value: string ``` ## Propiedades de `Image` `Name` (**Opcional**, `String`) Especifica el nombre de la AMI. Si no se especifica, se utiliza el nombre utilizado al llamar al [`pcluster build-image`](pcluster.build-image-v3.md) comando. ### `Tags` #### Propiedades de `Tags` (**Opcional**) Especifica los pares clave-valor para la imagen. ``` Tags: - Key: string Value: string ``` `Key` (**Opcional**, `String`) Define el nombre del clúster. `Value` (**Opcional**, `String`) Define el valor de etiqueta. ### `RootVolume` #### Propiedades de `RootVolume` (**Opcional**) Especifica las propiedades del volumen raíz de la imagen. ``` RootVolume: Size: integer Encrypted: boolean KmsKeyId: string ``` `Size` (**Opcional**, `Integer`) Especifica el tamaño del volumen raíz de la imagen, en GiB. El tamaño predeterminado es el tamaño del [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage)más de 27 GiB. `Encrypted` (**Opcional**, `Boolean`) Especifica si el volumen de está cifrado. El valor predeterminado es `false`. `KmsKeyId` (**Opcional**, `String`) Especifica el ARN de la AWS KMS clave utilizada para cifrar el volumen. El formato es el siguiente `arn:Partition:kms:Region:Account:key/KeyId`. # Sección de `DeploymentSettings` **nota** `DeploymentSettings`se añade a partir de la AWS ParallelCluster versión 3.4.0. **(Opcional)** Especifica la configuración de los ajustes de implementación. ``` DeploymentSettings: LambdaFunctionsVpcConfig: SecurityGroupIds: - string SubnetIds: - string ``` ## Propiedades de `DeploymentSettings` ### `LambdaFunctionsVpcConfig` **(Opcional)** Especifica las configuraciones de VPC de AWS Lambda las funciones. Para obtener más información, consulte [AWS Lambda Configuración de VPC en AWS ParallelCluster](lambda-vpc-v3.md). ``` LambdaFunctionsVpcConfig: SecurityGroupIds: - string SubnetIds: - string ``` #### `LambdaFunctionsVpcConfig properties` `SecurityGroupIds` (**Requerido**, `[String]`) La lista de grupos de seguridad de Amazon VPC adjuntos a IDs las funciones de Lambda. [Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3) `SubnetIds` (**Requerido**, `[String]`) La lista de subredes IDs que se adjuntan a las funciones de Lambda. [Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3) **nota** Las subredes y los grupos de seguridad deben estar en la misma VPC.