翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Image Builder を使用したカスタムイメージの作成
新しい Image Builder イメージを作成する方法はいくつかあります。たとえば、次のいずれかの方法を使用して、 AWS マネジメントコンソール または でイメージを作成できます AWS CLI。[CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html) API アクションを使用するか、ビルドパイプラインを実行してイメージを作成することもできます。API アクションに関連する SDK リクエストについては、「*EC2 Image Builder API」リファレンス*」で、目的のコマンドの「[関連項目](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso)」リンクを参照してください。
------
#### [ AWS マネジメントコンソール ]
既存のパイプラインで新しいイメージを作成するには、次のようにパイプラインを手動で実行できます。パイプラインウィザードを使用して新しいイメージを一から作成することもできます。作成するイメージのタイプに応じて、[パイプラインウィザード: AMI の作成](start-build-image-pipeline.md) または [パイプラインウィザード: コンテナイメージの作成](start-build-container-pipeline.md) を参照してください。
1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。
1. ナビゲーションペインから、[**イメージパイプライン**] を選択します。
1. 実行したい**パイプライン名**の横にあるチェックボックスを選択します。
1. イメージを作成するには、**アクション** メニューから **パイプラインを実行** を選択します。パイプラインが開始されます。
パイプラインを実行するスケジュールを指定したり、Amazon EventBridge を使用して設定したルールに基づいてパイプラインを実行したりすることもできます。
------
#### [ AWS CLI ]
で **[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** コマンドを実行する前に AWS CLI、次のリソースがまだ存在しない場合は作成する必要があります。
**必要なリソース**
+ **レシピ** - 以下のように、イメージに正確に 1 つのレシピを指定する必要があります。
イメージのレシピ
イメージレシピリソースの Amazon リソースネーム (ARN) を `--image-recipe-arn` パラメータで指定します。
コンテナレシピ
コンテナレシピリソースの ARN を `--container-recipe-arn` パラメータで指定します。
+ **インフラストラクチャ構成[** - `--infrastructure-configuration-arn`パラメータでインフラストラクチャ構成リソースの ARN を指定します。
Image Builder が必要とする以下のいずれかのリソースを指定できます。
**オプションのリソースと設定**
+ **配布設定** - デフォルトでは、Image Builder は、**create-image**コマンドを実行したリージョンのアカウントに出力イメージリソースを配布します。ディストリビューションに追加の宛先または設定を指定するには、`--distribution-configuration-arn` パラメータを使用してディストリビューション設定リソースの ARN を指定します。
+ **イメージスキャン** –イメージまたはコンテナテストインスタンス上で Amazon Inspector の検出結果用のスナップショットを構成するには、`--image-scanning-configuration` パラメータを使用します。コンテナイメージの場合は、Amazon Inspector がスキャンに使用する ECR リポジトリも指定します。
+ **イメージテスト** - Image Builder のテストステージを抑制するには、`--image-tests-configuration`パラメータを使用します。または、実行時間のタイムアウトを設定することもできます。
+ **イメージタグ** - 出力イメージリソースにタグを追加するには、`--tags` パラメータを使用します。
+ **イメージワークフロー** — ビルドワークフローまたはテストワークフローを指定しない場合、Image Builder はデフォルトのイメージワークフローでイメージを作成します。作成したワークフローを指定するには、`--workflows` パラメータを使用します。
**注記**
イメージワークフローを指定する場合は、Image Builder がワークフローアクションを実行するために使用する IAM ロールの名前または ARN も `--execution-role` パラメータで指定する必要があります。
次の例は、[「create-image」](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) AWS CLI コマンドを使用してImage Builder を使用してImage Builder を作成する方法を示しています。詳細については、『*AWS CLI コマンドリファレンス*』を参照してください。
**例: デフォルトのディストリビューションで基本的なイメージを作成する**
```
aws imagebuilder create-image --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0 --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-linux
```
**出力:**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0",
"name": "simple-recipe-linux",
...
}
]
}
```
------
## からイメージの作成をキャンセルする AWS CLI
進行中のイメージビルドをキャンセルするには、以下の**cancel-image-creation**コマンドを使用します。
```
aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1
```