本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
pcluster build-image
在指定区域创建自定义 Amazon ParallelCluster 镜像。
pcluster build-image [-h] --image-configuration
IMAGE_CONFIGURATION
--image-idIMAGE_ID
[--debug] [--dryrunDRYRUN
] [--queryQUERY
] [--regionREGION
] [--rollback-on-failureROLLBACK_ON_FAILURE
] [--suppress-validatorsSUPPRESS_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 区域 要使用的。 Amazon Web Services 区域 必须使用图像配置文件中的 “区域” 设置、
AWS_DEFAULT_REGION
环境变量、文件[default]
部分中的region
~/.aws/config
设置或--region
参数来指定。 --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-idcustom-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。