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

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

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

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

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

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

   注記

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

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

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

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

     注記

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

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

       ヒント

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

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

       重要

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

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

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

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

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

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

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

   • 親イメージ (文字列、必須) — コンテナレシピがカスタマイズ画像のベースとして使用します。値を入れられるのは、ベースイメージ 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パラメータで指定した Image Builder AMI からインスタンスを構築するためにアタッチするブロックデバイスを定義します。

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

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

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

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

         • 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. レシピを作成する

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

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

   注記

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

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