本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用映像建置器建立自訂映像
有幾種不同的方式可以建立新的映像建置器映像。例如，您可以使用下列其中一種方法來使用 AWS 管理主控台 或 建立映像 AWS CLI。您也可以使用 [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html) API 動作或執行建置管道來建立映像。如需與 API 動作相關聯的 SDK 請求，請參閱 *EC2 Image Builder API 參考*中該命令的 [See Also](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso) 連結。
------
#### [ AWS 管理主控台 ]
若要從現有管道建立新映像，您可以手動執行管道，如下所示。您也可以使用管道精靈從頭開始建立新映像。請參閱 [管道精靈：建立 AMI](start-build-image-pipeline.md)或 [管道精靈：建立容器映像](start-build-container-pipeline.md)，視您要建立的影像類型而定。
1. 開啟 EC2 Image Builder 主控台，位於 [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。
1. 從導覽窗格中選擇**映像管道**。
1. 選取您要執行之**管道名稱**旁的核取方塊。
1. 若要建立映像，請從**動作**功能表中選取**執行管道**。這會啟動管道。
您也可以指定執行管道的排程，或使用 Amazon EventBridge 根據您設定的規則執行管道。
------
#### [ AWS CLI ]
在 中執行**[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)**命令之前 AWS CLI，如果下列資源尚未存在，您必須建立這些資源：
**必要的資源**
+ **配方** – 您必須為映像只指定一個配方，如下所示：
映像配方
使用 `--image-recipe-arn` 參數為您的映像配方資源指定 Amazon Resource Name (ARN)。
容器配方
使用 `--container-recipe-arn` 參數為您的容器配方資源指定 ARN。
+ **基礎設施組態** – 使用 `--infrastructure-configuration-arn` 參數指定基礎設施組態資源的 ARN。
您也可以指定映像所需的下列任何資源：
**選用資源和組態**
+ **分佈組態** – 根據預設，Image Builder 會將輸出映像資源分佈到執行 **create-image**命令的區域中的帳戶。若要為您的分佈提供額外的目的地或組態，請使用 `--distribution-configuration-arn` 參數指定分佈組態資源的 ARN。
+ **映像掃描** – 若要為映像或容器測試執行個體上的 Amazon Inspector 調查結果設定快照，請使用 `--image-scanning-configuration` 參數。對於容器映像，您也可以指定 Amazon Inspector 用於掃描的 ECR 儲存庫。
+ **映像測試** – 若要隱藏映像建置器測試階段，請使用 `--image-tests-configuration` 參數。或者，您可以設定執行逾時的時間長度。
+ **映像標籤** – 使用 `--tags` 參數將標籤新增至輸出映像資源。
+ **映像工作流程** – 如果您未指定任何建置或測試工作流程，Image Builder 會使用其預設映像工作流程建立映像。若要指定您已建立的工作流程，請使用 `--workflows` 參數。
**注意**
如果您指定映像工作流程，您還必須提供映像建置器用來在 `--execution-role` 參數中執行工作流程動作的 IAM 角色名稱或 ARN。
下列範例示範如何使用 [create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) AWS CLI 命令建立映像。如需詳細資訊，請參閱 *AWS CLI 命令參考*。
**範例：使用預設分佈建立基本映像**
```
aws imagebuilder create-image --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0 --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-linux
```
**輸出：**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0",
"name": "simple-recipe-linux",
...
}
]
}
```
------
## 從 取消映像建立 AWS CLI
若要取消進行中的映像組建，請使用 **cancel-image-creation**命令，如下所示：
```
aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1
```