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

# イメージワークフローの作成
<a name="image-workflow-create-resource"></a>

イメージワークフローを作成すると、イメージの作成プロセスをより細かく制御できます。Image Builder がイメージをビルドするときに実行するワークフローと、イメージをテストするときに実行するワークフローを指定できます。また、カスタマーマネージドキーを指定してワークフローリソースを暗号化することもできます。ワークフローリソースの暗号化の詳細については、「[Image Builder での暗号化とキーの管理](data-protection.md#ib-encryption)」を参照してください。

イメージの作成には、ビルドステージのワークフローを 1 つと、テストステージのワークフローを 1 つ以上指定できます。必要に応じて、ビルドステージやテストステージを完全にスキップすることもできます。ワークフローが使用する YAML 定義ドキュメントで、ワークフローが実行するアクションを設定します。YAML ドキュメントの構文については「[YAML ワークフロードキュメントを作成する](image-workflow-create-document.md)」を参照してください。

ビルドワークフローまたはテストワークフローを新しく作成する手順については、使用する環境に合ったタブを選択してください。

------
#### [ AWS マネジメントコンソール ]

以下のプロセスを使用して、Image Builder コンソールで新しいワークフローを作成できます。

1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。

1. ナビゲーションペインから **[イメージワークフロー]** を選択します。これにより、アカウントが所有している、またはアクセスできるイメージワークフローのリストが表示されます。
**注記**  
Image Builder がデフォルトのワークフローに使用する Amazon マネージドワークフローリソースは、常にリストに表示されます。これらのワークフローの詳細を表示するには、**[ワークフロー]** リンクを選択します。

1. 新しいワークフローを作成するには、**[イメージワークフローを作成]** を選します。これにより、**[イメージワークフローを作成]** ページが表示されます。

1. 新しいワークフローの詳細を設定します。ビルドワークフローを作成するには、フォームの上部にある **[ビルド]** オプションを選択します。テストワークフローを作成するには、フォームの上部にある **[テスト]** オプションを選択します。Image Builder は、このオプションに基づいて **[テンプレート]** リストにデータを入力します。ビルドワークフローおよびテストワークフローのその他のステップは、すべて同じです。

**全般**  
一般セクションには、名前や説明など、ワークフローリソースに適用される設定が含まれます。一般設定には以下が含まれます。
   + **[イメージワークフロー名]** (必須) — イメージワークフローの名前。新しい名前は アカウント内で一意である必要があります。名前の最大長は 128 文字です。使用可能な文字は、文字、数字、スペース、`-`、および `_` です。
   + **[バージョン]** (必須) — 作成するワークフローリソースのセマンティックバージョン (major.minor.patch)。
   + **[説明]** (オプション) — オプションでワークフローの説明を追加します。
   + **[KMS キー]** (オプション) — カスタマーマネージドキーを使用してワークフローリソースを暗号化できます。詳細については、「[カスタマーマネージドキーを使用してイメージワークフローを暗号化する](data-protection.md#ib-workflow-encrypt-cmk)」を参照してください。

**定義ドキュメント**  
YAML ワークフロードキュメントには、ワークフローのすべての設定が含まれています。

**はじめに**
   + Image Builder のデフォルトテンプレートをワークフローのベースラインとして開始するには、**[テンプレートから開始]** オプションを選択します。このオプションはデフォルト選択。**[テンプレート]** リストから使用するテンプレートを選択すると、選択したテンプレートのデフォルト設定が新しいワークフロードキュメントの **[コンテンツ]** にコピーされ、そこで変更を加えることができます。
   + ワークフロードキュメントを最初から定義するには、**[ゼロから開始]** オプションを選択します。これにより、ドキュメント形式の重要な部分の簡単な概要が **[コンテンツ]** に入力され、作業を開始しやすくなります。

   **[コンテンツ]** パネルの下部には、YAML ドキュメントに関する警告やエラーを示すステータスバーがあります。YAML ワークフロードキュメントの作成方法の詳細については、「[YAML ワークフロードキュメントを作成する](image-workflow-create-document.md)」を参照してください。

1. ワークフローが完了したら、または進行状況を保存して後で戻りたい場合は、**[ワークフローを作成]** を選択します。

------
#### [ AWS CLI ]

で **[create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html)** コマンドを実行する前に AWS CLI、ワークフローのすべての設定を含む YAML ドキュメントを作成する必要があります。詳細については、「[YAML ワークフロードキュメントを作成する](image-workflow-create-document.md)」を参照してください。

次の例は、[create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI コマンドを使用してビルドワークフローを作成する方法を示しています。`--data` パラメータは、作成したワークフローのビルド設定を含む YAML ドキュメントを指します。

**例: ワークフローの作成**

```
aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml
```

**出力:**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

次の例は、[create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI コマンドを使用してテストワークフローを作成する方法を示しています。`--data` パラメータは、作成したワークフローのビルド設定を含む YAML ドキュメントを指します。

**例: テストワークフローの作成**

```
aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml
```

**出力:**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

------