翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `pcluster build-image`
<a name="pcluster.build-image-v3"></a>

指定されたリージョンにカスタム AWS ParallelCluster イメージを作成します。

```
pcluster build-image [-h]
                 --image-configuration IMAGE_CONFIGURATION 
                 --image-id IMAGE_ID
                [--debug]
                [--dryrun DRYRUN]
                [--query QUERY]
                [--region REGION]
                [--rollback-on-failure ROLLBACK_ON_FAILURE]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## 名前付き引数
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
`pcluster build-image` のヘルプテキストを表示します。

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
イメージ設定ファイルを YAML ドキュメントで指定します。

**--image-id, -i *IMAGE\$1ID***  
構築されるイメージの ID を指定します。

**--debug**  
デバッグログを有効にします。

**--dryrun *DRYRUN***  
`true` の場合、リソースを作成することなく、検証を行います。イメージの構成を検証するためにこれを使用することができます。(デフォルトは `false` です)

**--query *QUERY***  
出力時に実行する JMESPath クエリ。

**--region, -r *REGION***  
 AWS リージョン 使用する を指定します。イメージ設定ファイルの[リージョン](image-builder-configuration-file-v3.md#yaml-build-image-Region)設定、`AWS_DEFAULT_REGION`環境変数、`~/.aws/config`ファイルの `[default]`セクションの `region`設定、または `--region`パラメータを使用して、 を指定 AWS リージョン する必要があります。

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
`true` の場合、失敗するとイメージスタックのロールバックが自動的に開始されます。(デフォルトは `false` です)

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
抑制する 1 つまたは複数のコンフィグバリデータを指定します。  
形式: (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
作成が失敗する最小の検証レベルを指定します。(デフォルトは `ERROR` です)

** AWS ParallelCluster バージョン 3.1.2 の使用例:**

```
$ pcluster build-image --image-configuration image-config.yaml --image-id custom-alinux2-image
{
  "image": {
    "imageId": "custom-alinux2-image",
    "imageBuildStatus": "BUILD_IN_PROGRESS",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.2"
  }
}
```

**警告**  
`pcluster build-image` はデフォルトの VPC を使用します。デフォルトの VPC が削除された場合は、おそらく AWS Control Tower または AWS Landing Zone を使用して、イメージ設定ファイルでサブネット ID を指定する必要があります。詳細については、「[SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId)」を参照してください。