View a markdown version of this page

使用 Image Builder 创建自定义映像 - EC2 Image Builder
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用 Image Builder 创建自定义映像

您可以通过多种不同的方式创建新的 Image Builder 映像。例如,您可以使用以下方法之一来创建具有 Amazon Web Services 管理控制台 要么 Amazon CLI。你也可以使用 CreateImage API 操作或运行构建管道来创建镜像。有关与 API 操作关联的 SDK 请求,可参阅《EC2 Image Builder API 参考》中该命令的 See Also 链接。

Console

要从现有管道创建映像,您可以手动运行管道,如下所示。您也可以使用管道向导从头开始创建新映像。请参阅 管道向导:创建 AMI 或 管道向导:创建容器镜像,具体取决于您要创建的映像类型。

  1. 打开 EC2 映像生成器控制台,网址为 https://console.aws.amazon.com/imagebuilder/。

  2. 在左侧导航窗格中,选择管道。

  3. 选中要暂停的管道旁边的复选框。

  4. 要创建映像,请从 “操作” 菜单中选择 “运行管道”。这会启动管道。

您也可以指定运行管道的时间表,或使用亚马逊 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