pcluster build-image

在指定的區域中建立自訂 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}]

命名參數

-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-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。