使用增强的 AMI 分发功能 - EC2 Image Builder
解耦分布分发重试分发工作流程

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

使用增强的 AMI 分发功能

Image Builder 提供高级分发功能， AMIs 可让您灵活控制跨区域和账户的分布方式。这些功能将分发与构建过程分开，允许您按需分发现有图像，高效地从分发失败中恢复，并通过可自定义的工作流程实施受控的多阶段分发策略。

您可以在 Image Builder 中使用增强的 AMI 分发功能直接执行分发活动，而无需重新运行完整的映像构建。

解耦分布

DistributeImage API 接受三种类型的源图像引用：

  • AMI ID — 标准的 AMI 标识符（例如，ami-0abcdef1234567890）

  • SSM 参数 — 存储 AMI ID 的 SSM 参数（例如，）ssm:/my/ami/parameter

  • Image Builder 版本 ARN — 图像生成器图像版本 ARN

分发重试

如果图像分发失败，请使用 RetryImage API 重试分发。这避免了完整的映像重建，从而缩短了排除故障原因的时间。RetryImage在解决分发失败的根本原因后使用。

RetryImage API 接受映像构建版本 ARN（例如）。arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1当您调用 API 时，Image Builder 会使用原始分发配置和设置自动从故障点恢复分发过程。RetryImageAPI 可以重试在分发阶段、测试阶段或集成阶段失败的分发。它适用于以下状态：待处理、失败、已删除或可用。 AMIs

先决条件

在重试分发之前，请确保满足以下条件：

  • 您已经确定并解决了失败的根本原因。查看日志中的分发 CloudWatch 日志，了解错误详情。

  • 您拥有重试镜像构建所必需的 IAM 权限。

  • 对于跨账户分发失败，请验证目标账户EC2ImageBuilderDistributionCrossAccountRole中的是否已附加Ec2ImageBuilderCrossAccountDistributionAccess策略。

重要：如果不修复根本问题，重试将导致重复失败。

分发工作流程

分发工作流是一种新的工作流类型，它补充了构建和测试工作流程，使您能够通过顺序步骤定义和控制分发流程。通过分发工作流程，您可以创建自定义分发流程，包括 AMI 复制操作、 wait-for-action检查点、图像属性修改和其他与分发相关的步骤。这提供了对分布方式的结构化控制， AMIs 包括分步级可见性、并行分发功能和精细的错误报告。

要了解有关创建和自定义工作流程的更多信息，请参阅管理图像工作流程。