本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Image Builder 创建自定义映像
您可以通过多种不同的方式创建新的 Image Builder 映像。例如,您可以使用以下方法之一来创建具有 Amazon Web Services 管理控制台 要么 Amazon CLI。你也可以使用 CreateImage API 操作或运行构建管道来创建镜像。有关与 API 操作关联的 SDK 请求,可参阅《EC2 Image Builder API 参考》中该命令的 See Also 链接。
- Console
-
要从现有管道创建映像,您可以手动运行管道,如下所示。您也可以使用管道向导从头开始创建新映像。请参阅 管道向导:创建 AMI 或 管道向导:创建容器镜像,具体取决于您要创建的映像类型。
-
打开 EC2 映像生成器控制台,网址为 https://console.aws.amazon.com/imagebuilder/
。 -
在左侧导航窗格中,选择管道。
-
选中要暂停的管道旁边的复选框。
-
要创建映像,请从 “操作” 菜单中选择 “运行管道”。这会启动管道。
您也可以指定运行管道的时间表,或使用亚马逊 EventBridge 根据您配置的规则运行管道。
-
- Amazon CLI
-
在你运行之前 创建镜像
命令在 Amazon 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 会将发现结果的快照与您的图像一起保存,这样在扫描的资源不存在后,发现结果仍然可用。对于按需 AMI 扫描,Amazon Inspector 会扫描该版本创建的输出 AMI,结果将显示在 Amazon EC2 中。有关扫描类型的更多信息,请参阅 Image Builder 中的 Amazon Inspector 集成。如果您指定扫描配置, get-image 响应包括它,但图片列表的响应不包括它。对于管道生成的镜像, get-image 返回构建开始时管道的扫描配置。这个 get-image-pipeline 和 list-image-pipelines 响应包括管道的当前扫描配置。这个--image-scanning-configuration参数接受以下字段:-
图像ScanningEnabled (布尔值)— 设置为
true在构建的测试阶段使用亚马逊检查器扫描您的图像。设置为false,或省略该字段,以关闭扫描。你必须将其设置为true使用imageScanningTypes要么scanResultCondition。 -
ECR 配置 (object) — 仅适用于指定以下内容的请求
containerRecipeArn。为映像生成器推送给 Amazon Inspector 扫描的容器镜像副本设置亚马逊 ECR 存储库和标签。如果你开启扫描并指定repositoryName要么containerTags在ecrConfiguration对于指定以下内容的请求imageRecipeArn,则请求失败并显示InvalidParameterCombinationException。-
存储库名称 (字符串)— 扫描图像的现有亚马逊 ECR 存储库的名称,1—1024 个字符。有关存储库要求,请参阅 Image Builder 中的 Amazon Inspector 集成。如果省略它,映像生成器会使用
image-builder-image-scanning-repository,如果图像不存在,则将其创建,并在收集结果后将其删除。如果 Image Builder 未完成对发现结果的收集,或者如果您为自己的存储库命名,则图像将保留在存储库中。 -
容器标签 (字符串列表)-Image Builder 应用于其推送扫描的容器镜像的其他标签。映像生成器还会将自己的版本标签应用于该图像。每个标签的长度必须介于 1—1024 个字符之间。
-
-
图像ScanningTypes (字符串列表)-扫描的类型。仅指定一个值:
TEST_INSTANCE_CVE扫描测试实例,或ON_DEMAND_AMI_CVE扫描输出 AMI。你不能将这两种类型结合起来。如果您省略该字段,图像生成器会使用TEST_INSTANCE_CVE并将该值保存在扫描配置中。ON_DEMAND_AMI_CVE仅适用于指定以下内容的请求imageRecipeArn。有关更多信息,请参阅 使用按需 AMI 扫描扫描输出 AMI。 -
扫描ResultCondition (对象)-可选。仅在以下情况下适用
imageScanningTypes是ON_DEMAND_AMI_CVE。设置 AMI 可以得到的最严重的发现。如果 AMI 的发现更严重,则映像会失败。-
最大限度SeverityLabel (字符串)-必填项。图像可能有的最严重的发现。有效值为
INFORMATIONAL、LOW、MEDIUM和HIGH。A 计数了CRITICAL查找总是会导致图像失败。 -
修复可用 (布尔值)— 设置为
true仅计算有可用修复程序的调查结果。设置为false计算所有发现。默认值为true。在默认情况下,没有修复的严重发现不会使图像失效。如果您省略该字段, get-image 响应显示为true。
-
测试阶段要求如果你开启扫描并设置
imageTestsEnabled到false在--image-tests-configuration参数,请求失败并返回InvalidParameterCombinationException。此要求适用于 create-image, create-image-pipeline,以及 update-image-pipeline 命令。对于
TEST_INSTANCE_CVE扫描,如果你使用--workflows参数,仅包含一个CollectImageScanFindings逐步完成图像的测试工作流程。图像生成器不会检查此步骤,没有它,映像生成器也不会保存任何结果。这个 Amazon 管理express-test-image工作流程不包括此步骤。On-demand AMI 扫描要求Image Builder 拒绝设置的请求
imageScanningTypes到ON_DEMAND_AMI_CVE在以下情况下:-
该请求指定了
containerRecipeArn。 -
imageTestsEnabled为false。该请求失败并引发InvalidParameterCombinationException。
您无需指定执行角色。如果没有一个,Image Builder 会使用其服务相关角色运行扫描,其中包括扫描所需的权限。如果您在中指定执行角色
--execution-role参数,该角色必须具有这些权限。有关权限,请参阅 按需 AMI 扫描的权限。图像生成器添加了 Amazon 管理
test-ami-scan自动处理图像。你不必把它列在里面--workflows。有关更多信息,请参阅 AMI 扫描管理工作流程(test-ami-scan)。 -
-
映像测试-要禁用 Image Builder 测试阶段,请使用
--image-tests-configuration参数。你无法设置imageTestsEnabled到false当您启用图像扫描时。 -
映像标签 - 使用
--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", ... } ] }示例:使用按需 AMI 扫描创建映像
以下示例创建图像并请求按需 AMI 对输出 AMI 进行扫描。如果 AMI 发现了比以下更严重的修复方法,则映像会失败
HIGH。将以下扫描配置保存在名为的文件中scan-config.json:{ "imageScanningEnabled": true, "imageScanningTypes": ["ON_DEMAND_AMI_CVE"], "scanResultCondition": { "maximumSeverityLabel": "HIGH", "fixAvailable":true} }替换扫描配置中的以下值:
-
maximumSeverityLabel— 允许的最严重的发现。有效值为INFORMATIONAL、LOW、MEDIUM和HIGH。A 计数了CRITICAL查找总是会导致图像失败。 -
fixAvailable— 哪些发现要计算在内。输入true(默认)仅计算有可用修复程序的调查结果,或者false计算每一项发现。
然后运行以下命令 Amazon CLI 命令。用您自己的值替换区域、账户 ID、配方和基础设施配置名称:
aws imagebuilder create-image \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:111122223333:image-recipe/simple-recipe-linux/1.0.0\ --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:111122223333:infrastructure-configuration/simple-infra-config-linux\ --image-tests-configuration imageTestsEnabled=true \ --image-scanning-configuration file://scan-config.json -
- PowerShell
-
以下示例显示了如何使用 New-EC2IBImage cmdlet 来创建镜像。此示例使用默认分发设置:
New-EC2IBImage ` -ImageRecipeArn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0` -InfrastructureConfigurationArn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-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 - PowerShell
-
以下示例显示了如何使用 Stop-EC2IBImageCreation cmdlet 取消正在进行的映像构建:
Stop-EC2IBImageCreation -ImageBuildVersionArn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1