翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 拡張 AMI ディストリビューション機能を使用する
<a name="distribution-enhanced_functionality"></a>

Image Builder は、AMIs がリージョンやアカウントにどのように分散されるかを柔軟に制御できる高度な分散機能を提供します。これらの機能により、ビルドプロセスから分散を分離できるため、既存のイメージをオンデマンドで分散し、分散障害から効率的に復旧し、カスタマイズ可能なワークフローを通じて制御されたマルチステージ分散戦略を実装できます。

Image Builder で拡張 AMI ディストリビューション機能を使用すると、完全なイメージビルドを再実行することなく、ディストリビューションアクティビティを直接実行できます。

## 分離されたディストリビューション
<a name="decoupled-distribution"></a>

DistributeImage API は、次の 3 種類のソースイメージ参照を受け入れます。
+ **AMI ID** – 標準の AMI 識別子 (例: `ami-0abcdef1234567890`)
+ **SSM パラメータ** – AMI ID を保存する SSM パラメータ (例: `ssm:/my/ami/parameter`)
+ **Image Builder バージョン ARN** – Image Builder イメージバージョン ARN

## ディストリビューションの再試行
<a name="distribution-retry"></a>

イメージディストリビューションが失敗した場合、 `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`ポリシーがアタッチされていることを確認します。

**重要:** 根本的な問題を修正せずに再試行すると、繰り返し失敗します。

## ディストリビューションワークフロー
<a name="distribution-workflows"></a>

ディストリビューションワークフローは、ビルドワークフローとテストワークフローを補完する新しいワークフロータイプであり、シーケンシャルステップでディストリビューションプロセスを定義および制御できます。ディストリビューションワークフローを使用すると、AMI コピーオペレーション、wait-for-actionチェックポイント、イメージ属性の変更、その他のディストリビューション関連のステップを含むカスタムディストリビューションプロセスを作成できます。これにより、ステップレベルの可視性、並列分散機能、詳細なエラーレポートにより、AMIs分散方法の構造化された制御が可能になります。

ワークフローの作成とカスタマイズの詳細については、[「イメージワークフローの管理](manage-image-workflows.html)」を参照してください。