Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
创建映像
本节介绍如何创建 Image Builder 映像以及如何取消正在进行中的构建。
创建映像
您可以通过多种不同的方式创建新的 Image Builder 映像。例如,您可以使用以下方法之一使用 Amazon Web Services Management Console 或创建图像 Amazon CLI。您也可以使用 CreateImageAPI 操作。更多有关关联的 SDK 请求的信息,可参阅《EC2 Image Builder API 参考》中该命令的See Also链接。
- Amazon Web Services Management Console
-
要从现有管道创建映像,您可以手动运行管道,如下所示。您也可以使用管道向导从头开始创建新映像。请参阅 创建映像管道 或 创建映像管道,具体取决于您要创建的映像类型。
您还可以指定运行管道的计划,或者根据您配置的规则使用 Amazon EventBridge 运行您的管道。
- Amazon CLI
-
在中运行create-image命令之前 Amazon CLI,如果以下资源尚不存在,则必须创建这些资源:
您还可以指定映像所需的以下任意资源:
可选资源和配置
-
分配配置-默认情况下,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 Amazon CLI 命令创建映像。有关更多信息,请参阅 Amazon 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
",
...
}
]
}
取消映像创建(Amazon 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