本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用增强的 AMI 分发功能
Image Builder 提供高级分发功能,使您可以灵活地控制您的 AMI 在不同地区和账户中的分布方式。这些功能将分发与构建过程分开,允许您按需分发现有图像,高效地从分发失败中恢复,并通过可自定义的工作流程实施受控的多阶段分发策略。
您可以在 Image Builder 中使用增强的 AMI 分发功能直接执行分发活动,无需重新运行完整的映像构建。
解耦分布
该 DistributeImage API 接受三种类型的源图像引用:
-
AMI ID — 标准的 AMI 标识符(例如,
ami-0abcdef1234567890) -
SSM 参数 — 存储 AMI ID 的 SSM 参数(例如,)
ssm:/my/ami/parameter -
图像生成器版本 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 可以重试在分发阶段、测试阶段或集成阶段失败的发行版。它适用于处于以下状态的 AMI:待处理、失败、已删除或可用。
先决条件
在重试分发之前,请确保满足以下条件:
-
您已经确定并解决了失败的根本原因。查看日志中的分发 CloudWatch 日志,了解错误详情。
-
您拥有必要的 IAM 权限来重试映像构建。
-
如果跨账户分发失败,请验证目标账户
EC2ImageBuilderDistributionCrossAccountRole中的是否已附加Ec2ImageBuilderCrossAccountDistributionAccess策略。
重要:在未修复根本问题的情况下重试将导致反复失败。
分发工作流程
分发工作流是一种新的工作流类型,可补充生成和测试工作流程,使您能够通过连续步骤定义和控制分发流程。通过分发工作流程,您可以创建自定义分发流程,包括 AMI 复制操作、等待操作检查点、图像属性修改和其他与分发相关的步骤。这提供了对您的 AMI 分布方式的结构化控制,具有阶梯级可见性、并行分发功能和精细的错误报告。
要了解有关创建和自定义工作流程的更多信息,请参阅管理图像工作流程。