pcluster build-image - Amazon ParallelCluster
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

pcluster build-image

在指定区域创建自定义 Amazon 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}]

命名的参数

-h, --help

显示 pcluster build-image 的帮助文本。

--image-configuration, -c IMAGE_CONFIGURATION

将映像配置文件指定为 YAML 文档。

--image-id, -i IMAGE_ID

指定将要构建的映像的 ID。

--debug

启用调试登入

--dryrun DRYRUN

当为 true 时,该命令执行验证而不创建任何资源。您可以使用此参数来验证映像配置。(默认值为 false。)

--query QUERY

要对输出执行的 JMESPath 查询。

--region, -r REGION

指定要使用的 Amazon Web Services 区域。必须使用映像配置文件中的 Region 设置、AWS_DEFAULT_REGION 环境变量、~/.aws/config 文件 [default] 部分中的 region 设置或 --region 参数指定 Amazon Web Services 区域。

--rollback-on-failure ROLLBACK_ON_FAILURE

当为 true 时,会在失败时自动启动映像堆栈回滚。(默认值为 false。)

--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]

标识一个或多个要禁止的配置验证器。

格式:(ALL|type:[A-Za-z0-9]+)

--validation-failure-level {INFO,WARNING,ERROR}

指定将导致创建失败的最低验证级别。(默认值为 ERROR。)

使用 Amazon 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(可能是通过使用 Amazon Control Tower 或 Amazon 登录区而删除),则必须在映像配置文件中指定子网 ID。有关更多信息,请参阅 SubnetId