View a markdown version of this page

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

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

创建映像工作流

创建映像工作流时，您可以更好地控制映像创建过程。您可以指定在 Image Builder 构建图像时运行的工作流程、测试图像时运行的工作流程以及分发图像时运行的工作流程。您还可以指定客户托管密钥以加密工作流资源。要了解有关工作流资源加密的更多信息，请参阅Image Builder 中的加密和密钥管理。

对于映像创建，您可以指定一个生成阶段工作流程、一个或多个测试阶段工作流程以及一个分发阶段工作流程。你甚至可以完全跳过一个阶段，具体取决于你的需求。您可以在工作流使用的 YAML 定义文档中配置工作流执行的操作。有关 YAML 文档语法的更多信息，请参阅创建 YAML 工作流文档。

要创建新的构建、测试或分发工作流程，请选择与您的环境相匹配的选项卡。

Amazon Web Services 管理控制台

您可以按照以下步骤在 Image Builder 控制台中创建新的工作流。

  1. 在以下位置打开 EC2 映像生成器控制台https://console.aws.amazon.com/imagebuilder/。

  2. 从导航窗格中，选择映像工作流。此操作将显示您账户拥有或有权访问的映像工作流列表。

    注意

    该列表始终包含图像生成器在其默认工作流程中使用的亚马逊托管工作流程资源。要查看这些工作流程的详细信息，请选择工作流程链接。

  3. 要创建新的工作流，请选择创建映像工作流。此操作将显示创建映像工作流页面。

  4. 为新工作流配置详细信息。选择表单顶部附近的工作流类型：选择 “构建” 以创建生成工作流程，选择 “测试” 以创建测试工作流程，或选择 “分发” 以创建分发工作流程。工作流程类型映射到 API 中的Type值（BUILDTEST、或DISTRIBUTION）。Image Builder 会根据此选项填充模板列表。构建、测试和分发工作流程的所有其他步骤都相同。

    General

    “常规”部分包括适用于工作流资源的设置，例如名称和描述。“常规”设置包含以下内容：

    • 映像工作流名称（必需）– 映像工作流的名称。该名称在您的账户中必须是唯一的。名称长度不超过 128 个字符。有效字符包括字母、数字、空格、- 和 _。

    • 版本（必需）– 要创建的工作流资源的语义版本（major.minor.patch）。

    • 描述（可选）– 可以选择性为工作流添加描述。

    • KMS 密钥（可选）– 您可以使用客户托管密钥加密工作流资源。有关更多信息，请参阅 使用客户托管密钥加密映像工作流。

    定义文档

    YAML 工作流文档包含工作流的所有配置。

    开始使用

    • 要开始使用 Image Builder 默认模板作为工作流的基准，请选择从模板开始选项。已默认选定此选项。从模板列表中选择要使用的模板后，会将您选择的模板中的默认配置复制到新工作流文档的内容中，您可以在其中进行更改。

    • 要从头开始定义工作流文档，请选择从头开始选项。此操作会在内容中填充文档格式中一些重要部分的简短概述，以帮助您入门。

    内容面板底部有一个状态栏，显示 YAML 文档的警告或错误。有关如何创建 YAML 工作流文档的更多信息，请参阅创建 YAML 工作流文档。

  5. 完成工作流后，或者如果您想保存进度稍后返回，请选择创建工作流。

Amazon CLI

在运行中的create-workflow命令之前 Amazon CLI，必须创建包含工作流程所有配置的 YAML 文档。有关更多信息，请参阅 创建 YAML 工作流文档。

以下示例演示了如何使用 create-workflow Amazon CLI 命令创建构建工作流。--data 参数是指 YAML 文档，其中包含您创建的工作流的构建配置。

示例：创建工作流

aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml

输出：

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

以下示例演示了如何使用 create-workflow Amazon CLI 命令创建测试工作流。该--data参数指的是包含您创建的工作流程的测试配置的 YAML 文档。

示例：创建测试工作流

aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml

输出：

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

以下示例显示如何使用 create-workflow 命令创建分发工作流程 Amazon CLI 。该--data参数指的是包含您创建的工作流程的分发配置的 YAML 文档。

示例：创建分发工作流程 

aws imagebuilder create-workflow --name example-distribution-workflow --semantic-version 1.0.0 --type DISTRIBUTION --data file://example-distribution-workflow.yml

输出：

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/distribution/example-distribution-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}