View a markdown version of this page

Image Builder インフラストラクチャ設定の管理 - EC2 イメージビルダー

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

Image Builder インフラストラクチャ設定の管理

インフラストラクチャ設定は、Image Builder がイメージを構築してテストする Amazon EC2 環境を定義する再利用可能な Image Builder リソースです。イメージパイプラインを作成するときは、1 つのインフラストラクチャ設定をアタッチします。Image Builder は、パイプラインがビルドを実行するたびにこれらの設定を使用します。

インフラストラクチャ設定は別のリソースであるため、多くのパイプラインで同じビルド環境を再利用できます。個々のパイプラインを変更せずに、環境を 1 か所で更新することもできます。インフラストラクチャ設定を更新すると、変更は次のビルドで有効になります。変更は、既に進行中のビルドや Image Builder が既に作成したイメージには影響しません。

注記

インフラストラクチャ設定は、作成に役立つイメージとは独立しています。インフラストラクチャ設定を削除または編集しても、Image Builder が既に構築したイメージは変更されません。パイプラインがインフラストラクチャ設定を参照している場合、参照を削除するまでその設定を削除することはできません。

インフラストラクチャ設定を使用して、ビルド環境とテスト環境に次の設定を指定します。API フィールド名、必要な設定、制約については、EC2 Image Builder API リファレンスの「CreateInfrastructureConfiguration」を参照してください。

  • ビルドインスタンスとテストインスタンスのインスタンスタイプ。複数のインスタンスタイプを指定することをお勧めします。これにより、Image Builder は十分な容量のプールからインスタンスを起動できます。これにより、一時的なビルドエラーを減らすことができます。複数のタイプを指定すると、Image Builder は使用可能な容量を持つ最初のタイプからインスタンスを起動します。で使用可能なインスタンスタイプがない場合、ビルドは失敗します。

    Mac イメージの場合は、macOS をネイティブにサポートするインスタンスタイプを選択します。詳細については、「Amazon EC2 ユーザーガイド」の「Amazon EC2 Mac インスタンス」を参照してください。

  • ビルドインスタンスとテストインスタンスにコンポーネントを実行するアクセス許可を付与するインスタンスプロファイル。例えば、Amazon S3 からリソースを取得するコンポーネントがある場合、インスタンスプロファイルにはそれらのファイルにアクセスするためのアクセス権限が必要です。インスタンスプロファイルには、EC2 Image Builder がインスタンスと正常に通信するための最小限の権限セットも必要です。詳細については、「Image Builder を使用してカスタムイメージをビルドするためのセットアップ」を参照してください。

  • Image Builder がインスタンスを起動するアベイラビリティーゾーン、テナンシー、専有ホストを制御するインスタンス配置設定。

  • ネットワーク — ビルドインスタンスとテストインスタンスの VPC サブネットとセキュリティグループ。サブネットを指定する場合は、少なくとも 1 つのセキュリティグループも指定する必要があります。

  • ログ記録 – Image Builder がビルドフェーズとテストフェーズの AWSTOE アプリケーションログを保存する Amazon S3 の場所。Amazon S3 ログ記録を使用するには、インスタンスプロファイルにターゲットバケット () のs3:PutObjectアクセス許可が必要ですarn:aws:s3:::BucketName/*。Amazon S3 ログ記録を設定しない場合、Image Builder は AWSTOE アプリケーションログをビルドインスタンスとテストインスタンスにのみ保持します。

  • 設定のトラブルシューティング — Amazon EC2 キーペアと terminateInstanceOnFailure設定。これらの設定を使用すると、障害が発生したビルドインスタンスを実行したまま、そのインスタンスに接続して調査できます。

  • インスタンスに IMDSv2 トークンが必要かどうか、およびメタデータレスポンスホップ制限を制御するインスタンスメタデータオプション。

  • Image Builder がイメージが使用可能になったときやビルドが失敗したときなど、イメージビルドステータスに関するメッセージを発行する SNS トピック。詳細については、「Image Builder における Amazon SNS の統合」を参照してください。

    注記

    SNS トピックが暗号化されている場合、このトピックを暗号化するキーは、Image Builder サービスが実行されるアカウントにある必要があります。Image Builder は、他のアカウントのキーで暗号化された SNS トピックに通知を送信できません。

内容
ヒント

同じ型のリソースが複数にある場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。の Image Builder コマンドを使用したリソースのタグ付けの詳細については AWS CLI、このガイドのリソースにタグを付ける「」セクションを参照してください。