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]）

指定映像的安全性群組 ID 清單。

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 EC2 Linux 執行個體使用者指南中的使用 IMDSv2。

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

注意

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

Support Imds/ImdsSupport添加了 3.3.0 AWS ParallelCluster 版本。

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 CloudFormation 自訂資源的函數，該 AWS Lambda 函數會在建置完成時移除組建成品。Lambda 需要設定為允許擔任該角色的主體。格式是 arn:Partition:iam::Account:role/RoleName。

AdditionalIamPolicies(選擇性)

指定要附加至用於產生自訂 AMI 的 EC2 Image Builder 執行個體的其他 IAM 政策。

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

IAM 政策清單。格式是 arn:Partition:iam::Account:policy/PolicyName。

PermissionsBoundary（可選，String）

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

Components

Components 屬性

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

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

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

Value（可選，String）

指定元件的類型-值配對的值。當類型為時arn，這是 EC2 Image Builder 元件的 ARN。當 type 為時script，這是指向建立 EC2 Image Builder 元件時要使用的指令碼的 https 或 s3 連結。

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 相依性相容。

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