本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `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 區域 要使用的 。 AWS 區域 必須使用映像組態檔案中[的區域](image-builder-configuration-file-v3.md#yaml-build-image-Region)設定、`AWS_DEFAULT_REGION`環境變數、 `~/.aws/config` 檔案 `[default]`區段中的`region`設定或 `--region` 參數來指定 。

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
當 時`true`， 會在失敗時自動啟動映像堆疊轉返。（預設為 `false`。)

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
識別要隱藏的一或多個組態驗證器。  
格式：(`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
指定會導致建立失敗的最低驗證層級。（預設為 `ERROR`。)

**使用 3.1.2 AWS ParallelCluster 版的範例：**

```
$ 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 登陸區域，則必須在映像組態檔案中指定子網路 ID。如需詳細資訊，請參閱 [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId)。