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 arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersionまたは AMI ID のいずれかである必要がありますami-12345678。

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

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

Imds

Imds のプロパティ

（オプション） Amazon ImageBuilder EC2 のビルドおよびテストインスタンスメタデータサービス (IMDS) の設定を指定します。

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

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

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

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

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

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

注記

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 (オプション）

カスタム IAM の生成に使用される EC2 Image Builder インスタンスにアタッチする追加の AMI ポリシーを指定します。

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

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

PermissionsBoundary (オプション、String)

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

Components

Components のプロパティ

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

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

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

Value (オプション、String)

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

注記

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

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