本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
pcluster build-image
在指定的區域中建立自訂 AWS 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
-
指定 AWS 區域 要使用的。 AWS 區域 必須使用影像組態檔案中的「區域」(Region) 設定、
AWS_DEFAULT_REGION
環境變數、~/.aws/config
檔案區[default]
段中的region
設定或--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
。)
使用 AWS 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 (可能是使用 AWS Control Tower 或 AWS 登陸區域),則必須在映像設定檔中指定子網路 ID。如需詳細資訊,請參閱SubnetId。