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)

イメージを構築するためにインスタンスをプロビジョニングする既存のサブネットの ID を指定します。提供されるサブネットには、インターネットへのアクセスが必要です。

警告

pcluster build-image はデフォルトの VPC を使用します。デフォルトの VPC が、 AWS Control Tower または AWS Landing Zone を使用して削除された場合は、サブネット ID を指定する必要があります。

ParentImage (必須)、String)

ベースイメージを指定します。親イメージは、非 AWS ParallelCluster AMI でも、同じバージョンの公式 AWS ParallelCluster AMI でもかまいません。の別のバージョンの AWS ParallelCluster 公式またはカスタム AMI を使用することはできません AWS ParallelCluster。フォーマットは、イメージ arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion の ARN または AMI ID ami-12345678 のいずれかでなければなりません。

SecurityGroupIds (オプション、[String])

イメージのセキュリティグループ ID のリストを指定します。

Imds

Imds のプロパティ

（オプション） EC2 ImageBuilder build and test instance metadata service (IMDS) の設定を指定します。

Imds:
  ImdsSupport: string
ImdsSupport (オプション、String)

EC2 ImageBuilder build インスタンスとテストインスタンスでサポートされている IMDS バージョンを指定します。サポートされている値は、v2.0 および v1.0 です。デフォルト値は、v2.0です。

ImdsSupport が v1.0 に設定されている場合、IMDSv1 と IMDSv2 の両方がサポートされます。

ImdsSupport が v2.0 に設定されている場合、IMDSv2 のみがサポートされます。

詳細については、「Linux インスタンス用 EC2 ユーザーガイド」の「IMDSv2 の使用」を参照してください。

更新ポリシー: この設定が変更された場合、更新は許可されません。

注記

AWS ParallelCluster バージョン 3.7.0 以降、ImdsSupportデフォルト値は ですv2.0。ImdsSupport を v2.0 に設定し、カスタムアクション呼び出しにおいて、IMDSv1 を IMDSv2 に置き換えることをお勧めします。

AWS ParallelCluster バージョン Imds 3.3.0 で / のサポートが追加されImdsSupportました。

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 の生成に使用する EC2 Image Builder インスタンスにアタッチする追加の IAM ポリシーを指定します。

AdditionalIamPolicies:
  - Policy: string
Policy (オプション、[String])

IAM ポリシーの一覧。形式は arn:Partition:iam::Account:policy/PolicyName です。

PermissionsBoundary (オプション、String)

AWS ParallelClusterで作成されたすべてのロールのパーミッションバウンダリとして使用する IAM ポリシーの ARN です。許可の境界の詳細については、「IAM ユーザーガイド」の「IAM エンティティの許可の境界」を参照してください。形式は arn:Partition:iam::Account:policy/PolicyName です。

Components

Components のプロパティ

（オプション ) AMI ビルドプロセス中に使用する EC2 ImageBuilder コンポーネントと、 によってデフォルトで提供されるコンポーネントを指定します AWS ParallelCluster。このようなコンポーネントは、AMI のビルドプロセスをカスタマイズするために使用できます。詳細については、「AWS ParallelCluster AMI のカスタマイズ」を参照してください。

Components:
  - Type: string
    Value: string
Type (オプション、String)

コンポーネントのタイプ-値のペアのタイプを指定します。タイプは arn または script となります。

Value (オプション、String)

コンポーネントのタイプ-値のペアの値を指定します。タイプが arn の場合は、EC2 Image Builder コンポーネントの ARN です。タイプが 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 ソフトウェアをインストールする前に OS が更新され、再起動されます。デフォルトは false です。

注記

UpdateOsPackages を有効にすると、カーネルを含め、使用可能なすべての OS パッケージが更新されます。お客様には、更新が更新に含まれていない AMI の依存関係と互換性があることを確認する責任があります。

例えば、カーネル AWS ParallelCluster バージョン Y.0 と一部のコンポーネントバージョン Z.0 に同梱されているバージョン X.0 の AMI を構築するとします。利用可能な更新に、更新済みのカーネルバージョン Y.1 が含まれており、コンポーネント Z.0 への更新は行われていないとします。UpdateOsPackages を有効にする前に、コンポーネント Z.0 がカーネル Y.1 をサポートしていることを確認する責任があります。