本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `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`环境变量、文件`[default]`部分中的`region``~/.aws/config`设置或`--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`。）

**使用 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 着陆区域），则必须在映像配置文件中指定子网 ID。有关更多信息，请参阅 [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId)。