Build 部分 - Amazon ParallelCluster
Build 属性
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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 已被删除（可能使用 Amazon Control Tower 或 Amazon 着陆区域），则必须指定子网 ID。

ParentImage（必需，String）

指定基础映像。父映像可以是非 Amazon ParallelCluster AMI，也可以是同一版本的官方 Amazon ParallelCluster AMI。您不能使用不同版本的 Amazon ParallelCluster 官方或自定义 AMI Amazon 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 Amazon ParallelCluster 版开始，ImdsSupport默认值为。v2.0我们建议您在自定义操作调 IMDSv1 用 IMDSv2 中设置ImdsSupport为v2.0并替换为。

3.3.0 Amazon 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）

用于支持 Amazon CloudFormation 自定义资源的 Amazon 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）

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

Components

Components 属性

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

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

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

Value（可选，String）

指定组件的类型-值对的值。当类型为时arn，这是 I EC2 mage Builder 组件的 ARN。当类型为时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 属性

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

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

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

注意

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

例如，假设您正在为 Amazon 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。