翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Image Builder での仮想マシンイメージのインポートとエクスポート VM を仮想化環境からエクスポートすると、そのプロセスは VM の環境、設定、データのスナップショットとして機能する 1 つ以上のディスクコンテナファイルのセットを作成します。これらのファイルを使用して VM をインポートし、イメージレシピのベースイメージとして使用することができます。エクスポートするには、カスタムイメージビルドからの出力として VM ディスクファイルを作成し、ファイルを配布します。 Image Builder は VM ディスクコンテナの以下のファイル形式をサポートしています。 + オープン仮想化アーカイブ (OVA) + 仮想マシンディスク (VMDK) + バーチャルハードディスク (VHD/VHDX) + Raw インポートでは、ディスクを使用して Amazon マシンイメージ (AMI) と Image Builder イメージリソースを作成します。いずれもカスタムイメージレシピのベースイメージとして使用できます。インポートするには、VM ディスクを S3 バケットに保存する必要があります。別の方法として、既存の EBS スナップショットからインポートすることもできます。 Image Builder コンソールでは、イメージを直接インポートし、出力イメージまたは AMI をレシピで使用したり、レシピまたはレシピバージョンを作成するときにインポートパラメータを指定したりできます。イメージレシピの一部としてインポートする方法の詳細については、「[VM インポート設定](create-image-recipes.md#import-vm-recipe-console-config)」を参照してください。 ## Image Builder への VM のインポート Image Builder は Amazon EC2 VM Import/Export API と統合されているため、インポートプロセスをバックグラウンドで非同期的に実行できます。Image Builder は VM インポートのタスク ID を参照して進行状況を追跡し、出力として Image Builder イメージリソースを作成します。これにより、VM のインポートが完了する前に、レシピ内の Image Builder イメージリソースを参照できます。 ------ #### [ Console ] Image Builder コンソールで VM をインポートするには、次の手順に従います。 1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。 1. ナビゲーションペインから [**イメージ**] を選択します。 1. インポートダイアログを開くには、**イメージのインポート**を選択します。 1. 次の**一般**情報を入力します。 + イメージに一意の**名前**を指定します。 + ベースイメージの **バージョン** を指定します。形式は以下のようになります: `major.minor.patch` 1. インポートタイプを選択します: **VM import**。 1. **[イメージをインポート]** ページで、以下の各セクションに詳細を入力します。完了したら、**イメージのインポート]** を選択します。 **ベースイメージオペレーティングシステム** 1. お使いの VM OS プラットフォームに合った **[イメージオペレーティングシステム (OS)]** オプションを選択します。 1. お使いの VM バージョンと一致する **[OS バージョン]** をリストから選択します。 **VM インポート設定** 1. VM を仮想化環境からエクスポートすると、そのプロセスによって 1 つ以上のディスクコンテナファイルのセットが作成されます。これらは VM の環境、設定、データのスナップショットとして機能します。これらのファイルを使用して、VM をイメージレシピのベースイメージとしてインポートできます。Image Builder での VM インポートの詳細については、「[VM イメージのインポートとエクスポート](#vm-import-export)」を参照してください。 インポートソースの場所を指定するには、次の手順に従います。   **インポートソース** **ディスクコンテナ 1** セクションで、インポートする最初の VM イメージディスクコンテナまたはスナップショットのソースを指定します。 1. **ソース** — これは S3 バケットでも EBS スナップショットでもかまいません。 1. **ディスクの S3 の場所を選択** - ディスクイメージが保存されている Amazon S3 の場所を入力します。場所を参照するには、**[S3 を参照]** を選択します。 1. ディスクコンテナを追加するには、**[ディスクコンテナを追加]** を選択します。   1. **IAM ロール** IAM ロールを VM インポート設定に関連付けるには、**[IAM ロール]** ドロップダウンリストからロールを選択するか、[**新規ロールを作成**] を選択して新しいロールを作成します。新しいロールを作成すると、[IAM ロール] コンソールページが別のタブで開きます。   1. **詳細設定 - オプション** 次のオプション設定はオプショナルです。これらの設定により、インポートによって作成されるベースイメージの暗号化、ライセンス、タグなどを設定できます。 **ベースイメージアーキテクチャ** VM インポートソースのアーキテクチャを指定するには、**アーキテクチャ** リストから値を選択します。 **Encryption** VM ディスクイメージが暗号化されている場合は、インポートプロセスに使用するキーを指定する必要があります。インポート用の KMS キーを指定するには、**[暗号化 (KMS キー)]** リストから値を選択します。このリストには、現在のリージョンでアカウントがアクセスできる KMS キーが含まれています。 **ライセンス管理** VM をインポートすると、インポートプロセスによって VM OS が自動的に検出され、適切なライセンスがベースイメージに適用されます。お使いの OS プラットフォームに応じて、ライセンスの種類は次のとおりです。 + **License included** - あなたのプラットフォームに適した AWS ライセンスがベースイメージに適用されます。 + **Bring-Your-Own-License (BYOL)** - VM のライセンスを保持します（該当する場合）。 で作成されたライセンス設定をベースイメージ AWS License Manager にアタッチするには、**ライセンス設定名**リストから を選択します。License Manager の詳細については、[「 の使用 AWS License Manager]()」を参照してください。 **注記** ライセンスコンフィギュレーションには、企業契約の条件に基づくライセンスルールが含まれています。 Linux は BYOL ライセンスのみをサポートします。 **タグ (ベースイメージ)** タグはキーと値のペアを使用して、検索可能なテキストを Image Builder リソースに割り当てます。インポートしたベースイメージのタグを指定するには、**[キー]** ボックスと **[値]** ボックスを使用してキーと値のペアを入力します。 タグを追加するには、**[タグの追加]** を選択します。タグを削除するには、[**タグの削除**] を選択します。 ------ #### [ AWS CLI ] VM をディスクから AMI にインポートし、すぐに参照できる Image Builder イメージリソースを作成するには、 AWS CLIから以下の手順に従ってください。 1. AWS CLIの Amazon EC2 VM Import/Export **import-image** コマンドで、VM のインポートを開始する。コマンド・レスポンスで返されるタスク ID をメモしておく。これは次のステップで必要になります。詳細については、VM Import/Export ユーザーガイドの「[VM Import/Export を使用してイメージとして VM をインポート](https://docs.aws.amazon.com/vm-import/latest/userguide/vmimport-image-import.html)」を参照してください。   1. **CLI 入力 JSON ファイルの作成** で使用される Image Builder **import-vm-image** コマンドを合理化するために AWS CLI、コマンドに渡すすべてのインポート設定を含む JSON ファイルを作成します。 **注記** JSON ファイル内のデータ値の命名規則は、Image Builder API オペレーションリクエストパラメータに指定されたパターンに従います。API オペレーションリクエストパラメータを確認するには、*EC2 Image Builder API リファレンス*の [ImportVmImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ImportVmImage.html) オペレーションを参照してください。 データ値をコマンドラインパラメータとして指定するには、AWS CLI コマンドリファレンスで指定されているパラメータ名を参照してください。オプションとして、Image Builder **import-vm-image** コマンドに指定します。 以下に、この例で指定するパラメータの概要を示します。 + **名前** (文字列、必須) — インポートからの出力として作成する Image Builder イメージリソースの名前。 + **semanticVersion** (文字列、必須) — 出力イメージのセマンティックバージョンは次の形式で表されます: 各位置に特定のバージョン (..) を示す数値が付いています。例えば、`1.0.0`。Image Builder リソースのセマンティックバージョニングの詳細については、[Image Builder でのセマンティックバージョニング](ibhow-semantic-versioning.md)を参照してください。 + **説明** (文字列) — イメージレシピの説明。 + **platform** (文字列、必須) — インポートされた VM のオペレーティングシステムプラットフォーム。 + **VMImportTaskID** (文字列、必須) — Amazon EC2 VM インポートプロセスの `ImportTaskId` (AWS CLI)。Image Builder はインポートプロセスを監視して作成した AMI を取り込み、レシピですぐに使用できる Image Builder イメージリソースを構築します。 + **タグ** (文字列マップ) — タグはインポートリソースに添付されるキーと値のペアです。最大 50 個のキーと値のペアを使用できます。 ファイルに `import-vm-image.json` という名前を付けて保存し、Image Builder **import-vm-image** コマンドで使用します。 ``` { "name": "example-request", "semanticVersion": "1.0.0", "description": "vm-import-test", "platform": "Linux", "vmImportTaskId": "import-ami-01ab234567890cd1e", "tags": { "Usage": "VMIE" } } ``` 1. **イメージのインポート** 作成したファイルを入力として、**[import-vm-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-vm-image.html)** コマンドを実行します。 ``` aws imagebuilder import-vm-image --cli-input-json file://import-vm-image.json ``` **注記** JSON ファイルパスの先頭に `file://` 表記を含める必要があります。 JSON ファイルのパスは、コマンドを実行するベースオペレーティングシステムに適した規則に従う必要があります。例えば、Windows ではディレクトリパスを表すためにバックスプラッシュ (\$1) が使用され、Linux と macOS ではフォーワードスラッシュ (/) が使用されます。 ------ ## からイメージビルドから VM ディスクを配布する AWS CLI AWS CLIの Image Builder ディストリビューション設定を使用して、サポートされている VM ディスクフォーマットファイルの通常のイメージビルドプロセスの一部として、ターゲットリージョンの S3 バケットへの配布を設定できます。詳細については、「[例: から出力 VM ディスクのディストリビューション設定を作成する AWS CLI](cr-upd-ami-distribution-settings.md#cli-create-vm-dist-config)」を参照してください。