使用增強型 AMI 分佈功能 - EC2 Image Builder
解耦分佈分發重試分佈工作流程

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用增強型 AMI 分佈功能

Image Builder 提供進階分佈功能，可讓您靈活地控制 AMIs區域和帳戶中的分佈方式。這些功能將分發與建置程序分開，可讓您隨需分發現有的映像、有效率地從分發失敗中復原，並透過可自訂的工作流程實作受控的多階段分發策略。

您可以使用映像建置器中的增強型 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 會使用原始分佈組態和設定，自動從失敗點繼續分佈程序。RetryImage API 可以重試分佈階段、測試階段或整合階段期間失敗的分佈。它適用於下列狀態AMIs：待定、失敗、已刪除或可用。

先決條件

重試分佈之前，請確定下列事項：

  • 您已識別並解決失敗的根本原因。檢閱 CloudWatch Logs 中的分佈日誌以取得錯誤詳細資訊。

  • 您擁有重試映像建置所需的 IAM 許可。

  • 對於跨帳戶分佈失敗，請確認目的地帳戶中EC2ImageBuilderDistributionCrossAccountRole的 已連接Ec2ImageBuilderCrossAccountDistributionAccess政策。

重要事項：在不修正基礎問題的情況下重試會導致重複失敗。

分佈工作流程

分佈工作流程是補充建置和測試工作流程的新工作流程類型，可讓您使用循序步驟定義和控制分佈程序。透過分發工作流程，您可以建立自訂分發程序，其中包含 AMI 複製操作、wait-for-action檢查點、影像屬性修改和其他分發相關步驟。這可讓您透過步驟層級可見性、平行分佈功能和精細錯誤報告，對 AMIs分佈方式進行結構化控制。

若要進一步了解如何建立和自訂工作流程，請參閱管理映像工作流程。