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

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

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を参照してください。ディストリビューション設定リソースのタグを更新するには、「リソースのタグ付け」セクションを参照してください。