本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
在 Image Builder 配置映像管道工作流
使用图像工作流程,您可以自定义管道运行的工作流程,以根据需要构建、测试和分发图像。您定义的工作流在 Image Builder 工作流框架的上下文中运行。有关构成工作流框架的各个阶段的更多信息,请参阅管理映像生成器映像的构建、测试和分发工作流程。
- 构建工作流
-
构建工作流在工作流框架的
Build阶段运行。只能为管道指定一个构建工作流。或者可以完全跳过构建来配置仅测试管道。如果具有按需 AMI 扫描的管道跳过构建,则扫描的目标是配方的父 AMI。您的账户必须拥有该 AMI。有关更多信息,请参阅 使用按需 AMI 扫描的管道工作流程。 - 测试工作流
-
测试工作流在工作流框架的
Test阶段运行。您可以向管道中添加一个或多个测试工作流程,总共最多十个工作流程,这还包括您的构建和分发工作流程。测试工作流程可以并行运行,也可以一次运行一个,具体取决于您定义测试组的方式。如果您只想构建管道,也可以完全跳过测试,除非管道使用按需 AMI 扫描。 - 分发工作流程
-
分发工作流程在
Distribution工作流程框架的阶段。分发工作流程是可选的。如果您未指定,Image Builder 仍会通过运行您附加到管道或映像的分发配置来分发您的 AMI。当您想要使用不同的分发设置覆盖该分发配置,或者想提高分发过程的可见性时,请指定分发工作流程。您可以为管道指定一个分发工作流程。如果您构建容器镜像但未指定分配工作流程,Image Builder 会为您添加 Amazon 托管容器分发工作流程。
定义测试工作流的测试组
您可以在测试组中定义测试工作流程。您可以为您的管道运行多个测试工作流程。总共限制为十个工作流程,其中包括您的生成和分发工作流程。您可以决定是按特定顺序运行测试工作流,还是同时运行尽可能多的测试工作流。其运行方式取决于您如何定义测试组。以下场景演示了几种定义测试工作流的方法。
这个 parallelGroup 和 onFailure 设置仅适用于测试工作流程。Image Builder 在生成或分发工作流程中使用以下方法拒绝它们 InvalidParameterCombinationException。
测试组是如何运行的
映像生成器在测试组中运行您的测试工作流程。它一次只能运行一个小组。单个组中的测试工作流程同时运行(并行)。Image Builder 最多可同时运行五个测试工作流程;如果一个组有五个以上的测试工作流程,Image Builder 会在每个工作流程完成后启动下一个测试工作流程。不属于群组的测试工作流程会自行运行。
如何定义测试组取决于您使用的是控制台还是 Amazon CLI 和 API。选择与您使用的方法相匹配的选项卡。
场景 1:一次运行一个测试工作流
要一次运行所有测试工作流程,请为每个测试工作流程配置一个单独的测试组,总共不超过十个工作流程(包括您的生成和分发工作流程)的总和。映像生成器一次只能运行一个测试组。这是确保测试工作流按特定顺序逐一运行的一种方法。
场景 2:同时运行多个测试工作流
如果顺序无关紧要,并且您希望同时运行尽可能多的测试工作流,则可以配置单个测试组,并在其中放入最大数量的测试工作流。Image Builder 可同时启动多达五个测试工作流,并在其他工作流完成后启动其他测试工作流。如果您的目标是尽可能快地运行测试工作流,那么这是一种实现目标的方法。
场景 3:混合搭配
如果是混合场景,其中有些测试工作流可以同时运行,而另一些则应该一次运行一个,那么您可以配置测试组来实现这个目标。如何配置测试组的唯一限制是可以为管道运行的测试工作流的最大数量
使用按需 AMI 扫描的管道工作流程
当管道使用按需 AMI 扫描时,Image Builder 会运行 Amazon 管理 test-ami-scan 测试阶段的工作流程。Image Builder 会在每个流水线运行时添加工作流程,除非管道已经列出了该工作流程。有关扫描的更多信息,请参阅 使用按需 AMI 扫描扫描输出 AMI。
工作流程的运行位置取决于管道的工作流程:
-
默认工作流程 — 工作流程与
test-image工作流程,在同一个测试组中。 -
自定义工作流程 — Image Builder 在构建工作流程之后和测试工作流程之前插入工作流程,无需分组。它首先自行运行。
-
您在控制台中设置的工作流程 — 当你使用保存管道时 On-demand AMI 扫描 选中后,控制台会在您的第一个测试组开始时列出工作流程。它与该组中的其他测试工作流程同时运行。
该工作流程使用管道的执行角色。如果管道没有执行角色,则工作流程使用图像生成器服务相关角色,其中包括扫描所需的权限。如果您指定执行角色,则该角色必须具有这些权限。有关权限,请参阅 按需 AMI 扫描的权限。
十个工作流程的限制适用于您列出的工作流程。一个 test-ami-scan 列表中的工作流程计入限制。图像生成器在管道运行中添加的工作流程不是。
以下规则适用于使用按需 AMI 扫描的管道的工作流程:
-
Amazon CLI 和 API — 如果你指定
workflows如果没有生成工作流程,扫描的目标是配方的父 AMI,必须由您的账户拥有。你还必须开启图像测试。 -
控制台 — 那个 测试 部分显示了
test-ami-scan工作流为标记为锁定行 AMI 扫描是必需的,还有一个可选WaitForAmiScanTimeoutSeconds领域。你不能自己在测试工作流程列表中选择工作流程。要将其删除,请更改 EC2 图像扫描 在 高级设置。你不能跳过测试。当你的账号不拥有食谱的父图片时,你无法跳过构建,例如 Amazon Web Services Marketplace 图片或亚马逊管理的图片。
有关工作流程参数,请参阅 AMI 扫描管理工作流程(test-ami-scan)。
在控制台中为映像生成器管道设置工作流程参数
构建、测试和分发工作流程的工作流程参数的功能相同。创建或更新管道时,您可以选择要包括的构建、测试和分发工作流程。如果在工作流文档中为所选工作流定义了参数,则 Image Builder 会在参数面板中显示这些参数。对于未定义参数的工作流程,该面板处于隐藏状态。
每个参数都显示工作流文档定义的以下属性:
名称(不可编辑)– 参数的名称。
类型(不可编辑)- 参数值的数据类型。
-
值 – 参数的值。您可以编辑参数值以设置管道的参数值。
指定 Image Builder 用于运行工作流操作的 IAM 服务角色
当您将自定义映像工作流程附加到管道或设置日志记录配置时,还必须指定执行角色。这是映像生成器在运行您的工作流程操作时承担的 IAM 角色。该角色必须信任映像生成器服务主体。有关所需权限,请参阅以下工作流服务访问信息。
要运行映像工作流,Image Builder 需要获得执行工作流操作的权限。您使用映像生成器代表您承担的执行角色来授予此权限。您可以按如下方式分配执行角色。
我们建议你不要通过 AWSServiceRoleForImageBuilder 服务相关角色作为您的执行角色。相反,创建自定义 IAM 角色并附加 EC2ImageBuilderExecutionPolicy Amazon 管理策略。此政策授予的权限与 Image Builder 需要调用的权限相同 Amazon Web Services 服务 代表你。使用自定义角色可以完全控制映像生成器使用的权限。它还可以使您的服务控制策略 (SCP) 和资源控制策略 (RCP) 在 Image Builder 代表您执行的操作中保持有效。
-
控制台 — 在管道向导中 第 3 步:定义映像创建流程,请从中选择您的自定义角色 IAM 角色 清单在 服务访问权限 面板。
-
图像生成器 API — 在 CreateImage 操作请求,将您的自定义角色指定为的值
executionRole参数。
要创建自定义执行角色,请参阅 创建角色以委派权限给 Amazon 服务 在 Amazon Identity and Access Management 用户指南。
将工作流与管道关联
要将自定义构建、测试和分发映像工作流程与您的管道相关联,请选择与要使用的方法相匹配的选项卡。