Image Builder を使用して仮想マシンイメージをインポートおよびエクスポートする

VM を仮想化環境からエクスポートすると、そのプロセスによって VM 環境、設定、データのスナップショットとして機能する 1 つ以上のディスクコンテナファイルのセットが作成されます。これらのファイルを使用して VM をインポートし、イメージレシピのベースイメージとして使用することができます。

Image Builder は VM ディスクコンテナの以下のファイル形式をサポートしています。

• 仮想化アーカイブを開く (OVA）

• 仮想マシンディスク (VMDK）

• 仮想ハードディスク (VHD/VHDX）

• Raw

インポートでは、ディスクを使用して Amazon マシンイメージ (AMI) と Image Builder イメージリソースを作成します。どちらもカスタムイメージレシピのベースイメージとして機能します。インポートするには、VM ディスクを S3 バケットに保存する必要があります。または、既存のEBSスナップショットからインポートすることもできます。

Image Builder コンソールでは、イメージを直接インポートし、出力イメージまたはレシピAMIで使用するか、レシピまたはレシピバージョンの作成時にインポートパラメータを指定できます。イメージレシピの一部としてインポートする方法の詳細については、「VM インポート設定」を参照してください。

VM を Image Builder にインポートする

Image Builder は Amazon EC2 VM Import/Export と統合APIされ、インポートプロセスをバックグラウンドで非同期的に実行できるようにします。Image Builder は VM インポートのタスク ID を参照して進行状況を追跡し、出力として Image Builder イメージリソースを作成します。これにより、VM のインポートが完了する前に、レシピ内の Image Builder イメージリソースを参照できます。

Console

Image Builder コンソールで VM をインポートするには、次の手順に従います。

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

2. ナビゲーションペインから [イメージ] を選択します。

3. [イメージのインポート] を選択します。

4. イメージのインポートページで、以下の各セクションの詳細を入力します。完了したら、イメージのインポート] を選択します。

全般

1. ベースイメージに固有の 名前 を指定します。

2. ベースイメージの バージョン を指定します。形式は以下のようになります: major.minor.patch

3. オプションで、ベースイメージの [説明] を入力することもできます。

ベースイメージオペレーティングシステム

1. お使いの VM OS プラットフォームに合った [イメージオペレーティングシステム (OS)] オプションを選択します。

2. お使いの VM バージョンと一致する [OS バージョン] をリストから選択します。

VM インポート設定

1. VM を仮想化環境からエクスポートすると、そのプロセスによって 1 つ以上のディスクコンテナファイルのセットが作成されます。これらは VM の環境、設定、データのスナップショットとして機能します。これらのファイルを使用して、VM をイメージレシピのベースイメージとしてインポートできます。Image Builder VMsでのインポートの詳細については、「」を参照してくださいVM イメージのインポートとエクスポート。

   インポートソースの場所を指定するには、次の手順に従います。

    

   インポートソース

   ディスクコンテナ 1 セクションで、インポートする最初の VM イメージディスクコンテナまたはスナップショットのソースを指定します。

   1. ソース – これは S3 バケットまたはEBSスナップショットのいずれかです。

   2. ディスクの S3 の場所を選択 - ディスクイメージが保存されている Amazon S3 の場所を入力します。場所を参照するには、[S3 を参照] を選択します。

   3. ディスクコンテナを追加するには、[ディスクコンテナを追加] を選択します。

    

2. IAM ロール

   IAM ロールを VM インポート設定に関連付けるには、ロールドロップダウンリストからIAMロールを選択するか、新しいロールを作成を選択して新しいロールを作成します。新しいロールを作成すると、IAMロールコンソールページが別のタブで開きます。

    

3. 詳細設定 - オプション

   次のオプション設定はオプショナルです。これらの設定により、インポートによって作成されるベースイメージの暗号化、ライセンス、タグなどを設定できます。

   ベースイメージアーキテクチャ

   VM インポートソースのアーキテクチャを指定するには、アーキテクチャ リストから値を選択します。

   暗号化

   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. の Amazon VM Import/Export import-image コマンドを使用して、EC2VM のインポートを開始します AWS CLI。コマンド・レスポンスで返されるタスク ID をメモしておく。これは次のステップで必要になります。詳細については、VM Import/Export ユーザーガイドの「VM Import/Export を使用してイメージとして VM をインポート」を参照してください。

    

2. CLI 入力JSONファイルを作成する

   で使用される Image Builder import-vm-image コマンドを効率化するために AWS CLI、コマンドに渡すすべてのインポート設定を含むJSONファイルを作成します。

   注記

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

   データ値をコマンドラインパラメータとして指定するには、AWS CLI コマンドリファレンスで指定されているパラメータ名を参照してください。オプションとして、Image Builder import-vm-image コマンドに指定します。

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

   • 名前 (文字列、必須) — インポートからの出力として作成する Image Builder イメージリソースの名前。

   • semanticVersion (文字列、必須) – 出力イメージのセマンティックバージョン。次の形式でバージョンを指定します。各位置には、特定のバージョンを示す数値が付きます。<major>.<minor>.<patch>。例えば 1.0.0 です。Image Builder リソースのセマンティックバージョニングの詳細については、Image Builder でのセマンティックバージョニングを参照してください。

   • 説明 (文字列) — イメージレシピの説明。

   • platform (文字列、必須) — インポートされた VM のオペレーティングシステムプラットフォーム。

   • vmImportTaskID (文字列、必須) – Amazon EC2 VM のインポートプロセスの ImportTaskId (AWS CLI）。Image Builder はインポートプロセスをモニタリングして、AMI作成した をプルし、レシピで使用できる Image Builder イメージリソースをすぐに構築します。

   • clientToken (文字列、必須) — リクエストの冪等性を確保するために指定する、大文字と小文字を区別する一意の識別子。詳細については、「Amazon EC2APIリファレンス」の「冪等性の確保」を参照してください。

   • タグ (文字列マップ) — タグはインポートリソースに添付されるキーと値のペアです。最大 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",
       "clientToken": "asz1231231234cs3z",
       "tags": {
       	"Usage": "VMIE"
       }
   }

3. イメージのインポート

   作成したファイルを入力として、import-vm-image コマンドを実行します。

   aws imagebuilder import-vm-image --cli-input-json file://import-vm-image.json

   注記

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

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

からイメージビルドから VM ディスクを分散する AWS CLI

AWS CLIの Image Builder ディストリビューション設定を使用して、サポートされている VM ディスクフォーマットファイルの通常のイメージビルドプロセスの一部として、ターゲットリージョンの S3 バケットへの配布を設定できます。詳細については、「から出力 VM ディスクのディストリビューション設定を作成する AWS CLI」を参照してください。