本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Image Builder 创建自定义映像
您可以通过多种不同的方式创建新的 Image Builder 映像。例如，您可以使用以下方法之一使用 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 资源名称（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 Builder 测试阶段，请使用 `--image-tests-configuration` 参数。或者，你可以为它可以运行的时间设置一个超时值。
+ **映像标签** - 使用 `--tags` 参数向输出映像资源添加标签。
+ **映像工作流** – 如果您未指定任何构建或测试工作流，则 Image Builder 将使用其默认映像工作流创建映像。要指定已创建的工作流，请使用 `--workflows` 参数。
**注意**
如果指定映像工作流，则还必须在 `--execution-role` 参数中提供 Image Builder 用于运行工作流操作的 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
```