View a markdown version of this page

インフラストラクチャ設定を更新する - EC2 イメージビルダー

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

インフラストラクチャ設定を更新する

このセクションでは、 で Image Builder コンソールまたは imagebuilder コマンドを使用してインフラストラクチャ設定リソース AWS CLI を更新する方法について説明します。リソースを追跡するには、次のようにタグを適用できます。タグをキーと値のペアとして入力します。

  • リソースタグは、Image Builder がビルドプロセス中に起動する Amazon EC2 インスタンスにメタデータタグを割り当てます。

  • タグは、Image Builder が出力として作成するインフラストラクチャ設定リソースにメタデータタグを割り当てます。

Console

Image Builder コンソールから以下のインフラストラクチャー設定の詳細を編集できます。

  • インフラストラクチャ設定の 説明。

  • [IAM ロール] をインスタンスプロファイルに関連付けます。

  • インスタンスタイプや通知用の SNS トピックを含む AWS インフラストラクチャ。

  • VPC、サブネット、セキュリティグループ。

  • 障害発生時にインスタンスを終了する、接続用のキーペア、インスタンス Log 用のオプションの S3 バケットの場所などのトラブルシューティング設定。

Image Builder コンソールからインフラストラクチャ構成リソースを更新するには、以下の手順に従います。

既存の Image Builder インフラストラクチャー構成を選択してください

  1. https://console.aws.amazon.com/imagebuilder/ で、EC2 Image Builder コンソールを開きます。

  2. アカウントのインフラストラクチャー設定リソースのリストを表示するには、ナビゲーションペインから インフラストラクチャー設定 を選択します。

  3. インフラストラクチャー設定の詳細を表示したり編集したりするには、「設定名」リンクを選択します。これにより、インフラストラクチャ設定の詳細ビューが開きます。

    注記

    設定名 の横にあるボックスをオンにして、詳細を表示 を選択することもできます。

  4. インフラストラクチャー詳細 パネルの右上隅から 編集 を選択します。

  5. インフラストラクチャー設定に加えた更新を保存する準備ができたら、変更を保存 を選択します。

AWS CLI

次の例は、 AWS CLIで Image Builder の update-infrastructure-configuration コマンドを使用して、イメージのインフラストラクチャ設定を更新する方法を示しています。

  1. CLI 入力 JSON ファイルの作成

    この例では、 が に設定されている場合を除いて、設定terminateInstanceOnFailureは作成例と一致しますtrue。update-infrastructure-configuration コマンドを実行すると、このインフラストラクチャ設定を使用するパイプラインは、ビルドが失敗するとビルドインスタンスとテストインスタンスを終了します。

    次の の例では、一般的なインフラストラクチャフィールドを設定します。ビルドインスタンスとテストインスタンスで IMDSv2 トークンを要求するには、 を httpTokensに設定して instanceMetadataOptionsブロックを追加しますrequired。

    注記

    Image Builder がパイプラインビルドから起動するすべての EC2 インスタンスを IMDSv2 を使用するように設定して、インスタンスメタデータの取得リクエストに署名付きトークンヘッダーが必要になるようにすることをお勧めします。

    ファイル編集ツールを使用して、次の例に示すキーと環境に有効な値を含む JSON ファイルを作成します。この例では、update-infrastructure-configuration.jsonという名前のファイルを使用します。

    {
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
"description": "An example that will terminate instances of failed builds",
"instanceTypes": [
    "m7i.large", "m7i.2xlarge"
],
"instanceProfileName": "myIAMInstanceProfileName",
"securityGroupIds": [
    "sg-12345678"
],
"subnetId": "subnet-12345678",
"logging": {
    "s3Logs": {
        "s3BucketName": "my-logging-bucket",
        "s3KeyPrefix": "my-path"
    }
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}
  2. 以下のコマンドを実行する際には、作成したファイルを入力として使用します。
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json