コンテナイメージのディストリビューション設定を作成および更新する - EC2 Image Builder

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

コンテナイメージのディストリビューション設定を作成および更新する

このセクションでは、Image Builder コンテナイメージのディストリビューション設定の作成と更新について説明します。

から Image Builder コンテナイメージのディストリビューション設定を作成する AWS CLI

ディストリビューション設定を使用すると、出力コンテナイメージの名前と説明を指定し、コンテナイメージを他の AWS リージョンにレプリケートできます。ディストリビューション設定リソースと各リージョン内のコンテナイメージに別々のタグを適用することもできます。

  1. CLI 入力JSONファイルを作成する

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

    { "name": "distribution-configuration-name", "description": "Distributes container image to Amazon ECR repository in two regions.", "distributions": [ { "region": "us-west-2", "containerDistributionConfiguration": { "description": "My test image.", "targetRepository": { "service": "ECR", "repositoryName": "testrepo" }, "containerTags": ["west2", "image1"] } }, { "region": "us-east-1", "containerDistributionConfiguration": { "description": "My test image.", "targetRepository": { "service": "ECR", "repositoryName": "testrepo" }, "containerTags": ["east1", "imagedist"] } } ], "tags": { "DistributionConfigurationTestTagKey1": "DistributionConfigurationTestTagValue1", "DistributionConfigurationTestTagKey2": "DistributionConfigurationTestTagValue2" } }
  2. 作成したファイルを入力として使用し、次のコマンドを実行します。
    aws imagebuilder create-distribution-configuration --cli-input-json file://create-container-distribution-configuration.json
    注記
    • JSON ファイルパスの先頭にfile://表記を含める必要があります。

    • JSON ファイルのパスは、コマンドを実行しているベースオペレーティングシステムの適切な規則に従う必要があります。例えば、Windows ではディレクトリパスを参照するためにバックスプラッシュ (|) が使用され、Linux ではフォーワードスラッシュ (/) が使用されます。

    詳細については、AWS CLI コマンドリファレンスのcreate-distribution-configurationを参照してください。

からコンテナイメージのディストリビューション設定を更新する AWS CLI

以下の例では、update-distribution-configurationコマンドを使用して、 AWS CLIコマンドを使用して、コンテナイメージのディストリビューション設定を更新する方法を示しています。各リージョン内のコンテナイメージのタグを更新することもできます。

  1. CLI 入力JSONファイルを作成する

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

    { "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-container-distribution-configuration.json", "description": "Distributes container image to Amazon ECR repository in two regions.", "distributions": [ { "region": "us-west-2", "containerDistributionConfiguration": { "description": "My test image.", "targetRepository": { "service": "ECR", "repositoryName": "testrepo" }, "containerTags": ["west2", "image1"] } }, { "region": "us-east-2", "containerDistributionConfiguration": { "description": "My test image.", "targetRepository": { "service": "ECR", "repositoryName": "testrepo" }, "containerTags": ["east2", "imagedist"] } } ] }
  2. 作成したファイルを入力として使用し、次のコマンドを実行します。
    aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json
    注記
    • JSON ファイルパスの先頭にfile://表記を含める必要があります。

    • JSON ファイルのパスは、コマンドを実行しているベースオペレーティングシステムの適切な規則に従う必要があります。例えば、Windows ではディレクトリパスを参照するためにバックスプラッシュ (|) が使用され、Linux ではフォーワードスラッシュ (/) が使用されます。

    詳細については、AWS CLI コマンドリファレンスのupdate-distribution-configurationを参照してください。ディストリビューション設定リソースのタグを更新するには、「リソースのタグ付け」セクションを参照してください。