新しいコンテナレシピのバージョンを作成

新しいコンテナレシピのバージョンを作成するには:

1. コンテナレシピの詳細ページの上部で、新しいバージョンを作成 を選択します。コンテナレシピのレシピの作成ページが表示されます。

2. 新しいバージョンを作成するには、変更を加え、レシピの作成を選択します。

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

   create-container-recipe コマンドのすべての入力をインラインコマンドパラメータで指定できます。ただし、生成されるコマンドはかなり長くなる可能性があります。コマンドを合理化するには、代わりにすべてのコンテナレシピ設定を含むJSONファイルを提供できます。

   注記

   JSON ファイル内のデータ値の命名規則は、Image Builder APIアクションリクエストパラメータに指定されたパターンに従います。API コマンドリクエストパラメータを確認するには、EC2Image Builder APIリファレンス の CreateContainerRecipe コマンドを参照してください。

   データ値をコマンドラインパラメータとして指定するには、AWS CLI コマンドリファレンスで指定されているパラメータ名を参照してください。

   以下に、この例のパラメータの概要を示します。

   • コンポーネント (オブジェクトの配列、必須) — ComponentConfiguration オブジェクトの配列が含まれます。少なくとも 1 つのビルドコンポーネントを指定する必要があります。

     注記

     Image Builder は、レシピで指定した順序でコンポーネントをインストールします。ただし、CIS強化コンポーネントは常に最後に実行され、ベンチマークテストが出力イメージに対して実行されるようにします。

     • componentARN (文字列、必須) – コンポーネント ARN。

       ヒント

       この例を使用して独自のコンテナレシピを作成するには、この例をレシピに使用するARNsARNsコンポーネントの に置き換えます。これらには AWS リージョン、それぞれの、名前、バージョン番号が含まれます。

     • パラメータ (オブジェクトの配列) — ComponentParameter オブジェクトの配列が含まれます。入力パラメータは必要ですが、コンポーネントでデフォルト値が定義されていない場合は、値を指定する必要があります。Image Builder は、必須パラメータが欠落していてデフォルト値が定義されていない場合、レシピバージョンを作成しません。

       重要

       コンポーネントパラメータはプレーンテキストの値で、 AWS CloudTrailに記録されます。シークレットを保存するには、 AWS Secrets Manager または AWS Systems Manager Parameter Store を使用することをお勧めします。Secrets Manager の詳細については、AWS Secrets Manager ユーザーガイドの Secrets Manager とはを参照してください。 AWS Systems Manager パラメータストアについては、AWS Systems Manager ユーザーガイドのAWS Systems Manager パラメータストアを参照。

       • 名前 (文字列、必須) — 設定するコンポーネントパラメータの名前。

       • 値 (文字列の配列、必須) — 指定されたコンポーネントパラメータの値を設定する文字列の配列を含みます。コンポーネントにデフォルト値が定義されていて、他の値が指定されていない場合、 はデフォルト値 AWSTOE を使用します。

   • containerType (文字列、必須) – 作成するコンテナのタイプ。有効な値には DOCKER が含まれます。

   • dockerfileTemplateData (文字列) – イメージの構築に使用される Dockerfile テンプレート。インラインデータブロックとして表されます。

   • 名前 (文字列、必須) — コンテナレシピの名前。

   • 説明 (文字列) — コンテナレシピの説明。

   • parentImage (文字列、必須) – コンテナレシピがカスタマイズされたイメージのベースとして使用するイメージ。値は、ベースイメージARNまたは AMI ID にすることができます。

   • platformOverride (文字列) — カスタムベースイメージを使用する場合のオペレーティングシステムプラットフォームを指定します。

   • semanticVersion (文字列、必須) – 次の形式で指定されたコンテナレシピのセマンティックバージョン。各位置の数値は、特定のバージョンを示します: <major>.<minor>.<patch>。文字列の例は 1.0.0 などです。Image Builder リソースのセマンティックバージョニングの詳細については、Image Builder でのセマンティックバージョニングを参照してください。

   • タグ (文字列マップ)コンテナレシピにアタッチされているタグ。

   • instanceConfiguration (オブジェクト) – コンテナイメージを構築およびテストするためのインスタンスの設定に使用できるオプションのグループ。

     • image (文字列) – コンテナビルドインスタンスとテストインスタンスのベースイメージとして使用する AMI ID。この値を指定しない場合、Image Builder は適切な Amazon ECS 最適化をベースイメージAMIとして使用します。

     • blockDeviceMappings (オブジェクトの配列) – imageパラメータでAMI指定された Image Builder からインスタンスを構築するためにアタッチするブロックデバイスを定義します。

       • deviceName (文字列) – これらのマッピングが適用されるデバイス。

       • ebs (オブジェクト) – このマッピングの Amazon EBS固有の設定を管理するために使用されます。

         • deleteOnTermination (ブール値) – 関連付けられたデバイスの終了時に削除を設定するために使用されます。

         • 暗号化済み (ブール値) — デバイス暗号化の設定に使用されます。

         • volumeSize (整数) – デバイスのボリュームサイズを上書きするために使用します。

         • volumeType (文字列) – デバイスのボリュームタイプを上書きするために使用します。

   • targetRepository (オブジェクト、必須) – パイプラインが実行されるリージョン (リージョン 1) のパイプラインのディストリビューション設定に他のリポジトリが指定されていない場合のコンテナイメージの送信先リポジトリ。

     • repositoryName (文字列、必須) – 出力コンテナイメージが保存されているコンテナリポジトリの名前。この名前の先頭には、リポジトリの場所が付きます。

     • サービス (文字列、必須) - このイメージが登録されたサービスを指定します。

   • workingDirectory (文字列) – ビルドおよびテストワークフローで使用する作業ディレクトリ。

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

2. レシピを作成する

   レシピを作成するには以下のコマンドを使用します。--cli-input-json パラメータの前のステップで作成したJSONファイルの名前を指定します。

   aws imagebuilder create-container-recipe --cli-input-json file://create-container-recipe.json

   注記

   • JSON ファイルパスの先頭にfile://表記を含める必要があります。

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