Build 部分 - AWS ParallelCluster
Build 属性

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Build 部分

（必需）指定用于构建映像的配置。

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

Build 属性

InstanceType（必需，String）

指定用于构建映像的实例的实例类型。

SubnetId（可选，String）

指定要在其中预置用于构建映像的实例的现有子网的 ID。提供的子网需要互联网访问权限。

警告

pcluster build-image 使用默认 VPC。如果默认 VPC 已被删除（可能使用 AWS Control Tower 或 AWS 着陆区域），则必须指定子网 ID。

ParentImage（必需，String）

指定基础映像。父映像可以是非 AWS ParallelCluster AMI，也可以是同一版本的官方 AWS ParallelCluster AMI。您不能使用不同版本的 AWS ParallelCluster 官方或自定义 AMI AWS ParallelCluster。格式必须是映像的 ARN arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion 或 AMI ID ami-12345678。

SecurityGroupIds（可选，[String]）

指定镜像的安全 IDs 组列表。

Imds

Imds 属性

（可选）指定 Amazon EC2 ImageBuilder 构建和测试实例元数据服务 (IMDS) 设置。

Imds:
  ImdsSupport: string
ImdsSupport（可选，String）

指定 Amazon EC2 ImageBuilder 构建和测试实例支持哪些 IMDS 版本。支持的值为 v2.0 和 v1.0。默认值为 v2.0。

如果设置ImdsSupport为v1.0， IMDSv2 则同时支持 IMDSv1 和。

如果设置ImdsSupport为v2.0，则仅支持 IMDSv2 该选项。

有关更多信息，请参阅《适用于 Linux 实例的 Amazon EC2 用户指南》 IMDSv2中的 “使用”。

更新策略：如果更改此设置，则不允许更新。

注意

从 3.7.0 AWS ParallelCluster 版开始，ImdsSupport默认值为。v2.0我们建议您在自定义操作调 IMDSv1 用 IMDSv2 中设置ImdsSupport为v2.0并替换为。

3.3.0 AWS ParallelCluster 版本ImdsSupport中增加了对 Imds/的支持。

Iam

Iam 属性

（可选）指定映像构建的 IAM 资源。

Iam:
  InstanceRole: string
  InstanceProfile: string
  CleanupLambdaRole: string
  AdditionalIamPolicies:
    - Policy: string
  PermissionsBoundary: string
InstanceProfile（可选，String）

指定实例配置文件以覆盖 EC2 Image Builder 实例的默认实例配置文件。 InstanceProfile和InstanceRole和AdditionalIamPolicies不能一起指定。格式为 arn:Partition:iam::Account:instance-profile/InstanceProfileName。

InstanceRole（可选，String）

指定一个实例角色来覆盖 EC2 Image Builder 实例的默认实例角色。 InstanceProfile和InstanceRole和AdditionalIamPolicies不能一起指定。格式为 arn:Partition:iam::Account:role/RoleName。

CleanupLambdaRole（可选，String）

用于支持 AWS CloudFormation 自定义资源的 AWS Lambda 函数的 IAM 角色的 ARN，该资源将在构建完成后移除构建工件。需要将 Lambda 配置可以担任该角色的主体。格式为 arn:Partition:iam::Account:role/RoleName。

AdditionalIamPolicies（可选）

指定要附加到用于生成自定义 AMI 的 I EC2 mage Builder 实例的其他 IAM 策略。

AdditionalIamPolicies:
  - Policy: string
Policy（可选，[String]）

IAM 策略的列表。格式为 arn:Partition:iam::Account:policy/PolicyName。

PermissionsBoundary（可选，String）

要用作 AWS ParallelCluster创建的所有角色的权限边界的 IAM 策略的 ARN。有关 IAM 权限边界的更多信息，请参阅 IAM 用户指南 中的 IAM 实体的权限边界。格式为 arn:Partition:iam::Account:policy/PolicyName。

Components

Components 属性

（可选）除了默认提供的 EC2 ImageBuilder 组件外，指定在 AMI 构建过程中要使用的 Amazon 组件 AWS ParallelCluster。此类组件可用于自定义 AMI 构建过程。有关更多信息，请参阅 AWS ParallelCluster AMI 自定义。

Components:
  - Type: string
    Value: string
Type（可选，String）

指定组件的类型-值对的类型。类型可以是 arn 或 script。

Value（可选，String）

指定组件的类型-值对的值。当类型为时arn，这是 I EC2 mage Builder 组件的 ARN。当 type 为时script，这就是 https or s3 link pointing to the script to use when creating the EC2 Image Builder com重点。

Tags

Tags 属性

（可选）指定要在用于构建 AMI 的资源中设置的标签列表。

Tags:
  - Key: string
    Value: string
Key（可选，String）

定义标签的名称。

Value（可选，String）

定义标签的值。

UpdateOsPackages

UpdateOsPackages 属性

（可选）指定在安装 AWS ParallelCluster 软件堆栈之前是否更新操作系统。

UpdateOsPackages:
  Enabled: boolean
Enabled（可选，Boolean）

如果是true，则在安装软件之前更新并重新启动操作系统。 AWS ParallelCluster 默认为 false。

注意

启用 UpdateOsPackages 后，将会更新所有可用的操作系统程序包，包括内核。作为客户，您负责验证更新是否与更新中未包含的 AMI 依赖项兼容。

例如，假设您正在为 AWS ParallelCluster 版本 X.0 构建一个 AMI，该版本随内核版本 Y.0 和某个组件版本 Z.0 一起提供。假设可用更新包括更新的内核版本 Y.1，但没有组件 Z.0 的更新。在启用 UpdateOsPackages 之前，您应负责验证组件 Z.0 是否支持内核 Y.1。

Installation

Installation 属性

（可选）指定要在映像上安装的其他软件。

Installation:
  NvidiaSoftware: 
    Enabled: boolean
  LustreClient:
    Enabled: boolean
NvidiaSoftware属性（可选）

指定要安装的 Nvidia 软件。

NvidiaSoftware: 
    Enabled: boolean
Enabled（可选，boolean）

如果是true，则将安装 Nvidia GPU 驱动程序和 CUDA。默认为 false。

LustreClient属性（可选）

指定将安装 Amazon FSx Lustre 客户端。

LustreClient:
    Enabled: boolean
Enabled（可选，boolean）

如果是true，则将安装 Lustre 客户端。默认为 true。