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

# からコンテナイメージパイプラインを作成する AWS CLI
<a name="cli-create-container-pipeline"></a>

からイメージパイプラインを作成するには AWS CLI、パイプラインに適用される設定オプションを指定して **create-image-pipeline** コマンドを実行します。すべてのパイプライン設定を含む JSON ファイルを作成するか、実行時に設定を指定することができます。このセクションでは、JSON 設定ファイルメソッドを使用してコマンドを簡素化します。

ベースイメージとコンポーネントからの保留中の更新を組み込むために、パイプラインが新しいイメージをビルドする頻度は、設定した `schedule` 内容によって異なります。各 `schedule` には次の属性があります。
+ `scheduleExpression`— パイプラインの実行スケジュールを設定して、そのパイプラインを評価し、 `pipelineExecutionStartCondition` とビルドを開始すべきかどうかを判断します。スケジュールは cron 式で設定されます。Image Builder で cron 式を書式設定する方法については、「[Image Builder での cron 式の使用](cron-expressions.md)」を参照してください。
+ `pipelineExecutionStartCondition` — パイプラインでビルドを開始するかどうかを決定します。有効な値を次に示します。
  + `EXPRESSION_MATCH_ONLY` — cron 式が現在の時刻と一致するたびに、パイプラインが新しいイメージが作成されます。
  + `EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE` — ベースイメージまたはコンポーネントに保留中の変更がない限り、パイプラインは新しいイメージビルドを開始しません。

で **create-image-pipeline** コマンドを実行する場合 AWS CLI、設定リソースの多くはオプションです。ただし、パイプラインが作成するイメージのタイプによっては、条件付きの要件があるリソースもあります。コンテナイメージパイプラインには以下のリソースが必要です：
+ コンテナレシピ ARN
+ インフラストラクチャ設定ARN

コマンドを実行するときにディストリビューション設定リソースを含めない場合、出力イメージは、**create-image-pipeline**コマンドを実行するリージョンのコンテナレシピでターゲットリポジトリとして指定した ECR リポジトリに保存されます。パイプラインにディストリビューション設定リソースを含めると、ディストリビューションの最初のリージョンに指定したターゲットリポジトリが使用されます。

1. 

**CLI 入力 JSON ファイルの作成**

   お気に入りのファイル編集ツールを使って、以下のキーと、あなたの環境で有効な値を持つ JSON ファイルを作成します。この例では、`create-image-pipeline.json`という名前のファイルを使用します。

   ```
   {
   	"name": "MyWindows2019Pipeline",
   	"description": "Builds Windows 2019 Images",
   	"enhancedImageMetadataEnabled": true,
   	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-example-recipe/2020.12.03",
   	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
   	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration",
   	"imageTestsConfiguration": {
   		"imageTestsEnabled": true,
   		"timeoutMinutes": 60
   	},
   	"schedule": {
   		"scheduleExpression": "cron(0 0 * * SUN *)",
   		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
   	},
   	"status": "ENABLED"
   }
   ```
**注記**  
JSON ファイルパスの先頭に`file://`ノテーションを含める必要があります。
JSON ファイルのパスは、コマンドを実行するベースオペレーティングシステムに適した規則に従う必要があります。例えば、Windows ではディレクトリパスを表すためにバックスプラッシュ (\$1) が使用され、Linux と macOS ではフォーワードスラッシュ (/) が使用されます。

1. 作成したファイルを入力として使用し、次のコマンドを実行します。

   ```
   aws imagebuilder create-image-pipeline --cli-input-json file://create-image-pipeline.json
   ```