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

Build 屬性

InstanceType（必填，String）

指定用來建置映像檔之執行個體的執行個體類型。

SubnetId（可選，String）

指定要佈建執行個體以建置映像檔的現有子網路識別碼。提供的子網路需要網際網路存取。

警告

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，則同時支援IMDSv1和IMDSv2。

如果ImdsSupport設定為v2.0，則IMDSv2僅支援。

如需詳細資訊，請參閱 Amazon Linux 執行個體使用EC2者指南IMDSv2中的使用。

更新原則：如果變更此設定，則不允許更新。

注意

開始於 AWS ParallelCluster 版本 3.7.0，ImdsSupport預設值為v2.0。我們建議您在自訂動作呼叫IMDSv2中IMDSv1設定ImdsSupport為v2.0並取代為。

Sup Imdsport/ImdsSupport添加了 AWS ParallelCluster 版本 3.3.0.

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）

要用於的IAM角色 ARN AWS Lambda 功能支持 AWS CloudFormation 自訂資源，可在組建完成時移除組建成品。Lambda 需要設定為允許擔任該角色的主體。格式是 arn:Partition:iam::Account:role/RoleName。

AdditionalIamPolicies(選擇性)

指IAM定要附加至用於產生自訂EC2影像產生器執行個體的其他原則AMI。

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

IAM原則清單。格式是 arn:Partition:iam::Account:policy/PolicyName。

PermissionsBoundary（可選，String）

用來作為由建立ARN之所有角色之權限界限的IAM原則 AWS ParallelCluster。 如需有關IAM權限界限的詳細資訊，請參閱IAM使用者指南中IAM實體的權限界限。格式是 arn:Partition:iam::Account:policy/PolicyName。

Components

Components 屬性

(選擇性) 除了預設提供的外，指定AMI建置程序期間要使用的 Amazon EC2 ImageBuilder 元件 AWS ParallelCluster。 這些組件可用於自定義AMI構建過程。如需詳細資訊，請參閱AWS ParallelCluster AMI 定制。

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

指定元件的類型-值配對的類型。類型可以是arn或script。

Value（可選，String）

指定元件的類型-值配對的值。當 type 為時arn，這是EC2影 Image 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 屬性

(選擇性) 指定在安裝前是否更新作業系統 AWS ParallelCluster 軟體堆疊。

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

如果true，作業系統已更新並重新啟動，然後再安裝 AWS ParallelCluster 軟件。預設值為 false。

注意

啟用UpdateOsPackages時，所有可用的 OS 套件都會更新，包括核心。身為客戶，您必須負責確認更新是否與更新中未包含的相AMI依性相容。

例如，假設您正在構建一AMI個 AWS ParallelCluster 核心版本 Y.0 和某些元件版本 Z.0 隨附的 X.0 版。假設可用的更新包含更新的核心版本 Y.1，而不更新元件 Z.0。在啟用之前UpdateOsPackages，您有責任確認元件 Z.0 是否支援 kernel Y.1。