このページは Cloud Translation API によって翻訳されました。

仮想ディスクをインポートする

Linux Windows

必要なソフトウェアと構成を備えた仮想ディスク（ゴールデンディスクまたはゴールデンイメージと呼ばれることもあります）がオンプレミス環境にある場合、その仮想ディスクを Compute Engine にインポートし、そのイメージを使用して仮想マシンを作成することによって、時間を節約できます。インポートツールは、VMDK や VHD などのほとんどの仮想ディスクファイル形式をサポートしています。

Compute Engine からディスクをエクスポートした場合、ディスクからイメージを作成できます。

複数の仮想マシン（VM）を移行するための自動システムを作成する方法については、Compute Engine への VM の移行をご覧ください。

始める前に

イメージをインポートするプロジェクトのために定義された信頼できるイメージのポリシーがある場合は、パブリッシャーの許可リストに projects/compute-image-import と projects/compute-image-tools を追加します。
イメージをインポートする前に要件を満たす方法については、VM イメージのインポートとエクスポートの前提条件をご覧ください。
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. デフォルトのリージョンとゾーンを設定します。
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

サポートされているオペレーティングシステム

起動可能なディスクと起動できないディスクの両方がインポートできます。仮想ディスクを Compute Engine で起動できるようにするには、サポートされているオペレーティングシステムのいずれかを実行している必要があります。

BYOL と BYOS のサポート

所有しているソフトウェアライセンスまたはサブスクリプションを使用する場合は、それらのライセンスで仮想ディスクをインポートできます。BYOL または BYOS をサポートするオペレーティングシステムについては、オペレーティングシステムの詳細をご覧ください。

既存のライセンスを含むイメージをインポートするには、--byol フラグを指定して gcloud compute instances import コマンドを実行します。

制限事項

この機能の一般的な制限事項は次のとおりです。

RHEL を実行する仮想ディスクをインポートする場合は、インポートする前に仮想ディスクに python-boto パッケージがインストールされている場合にのみ、BYOL（お客様所有ライセンスの使用）がサポートされます。
仮想ディスク上のオペレーティングシステムが ACPI をサポートしている必要があります。
この機能は、VPC Service Controls で保護されているプロジェクトではサポートされていません。これらの環境については、ブートディスクの手動インポートをご覧ください。
イメージインポートツールを使用して Arm イメージをインポートすることはできません。Arm イメージをインポートするには、ブートディスクを手動でインポートするで説明されている手順に沿って操作します。
Compute Engine では、ソフトウェアで暗号化されたディスクは、鍵なしで読み取ることができないため、インポートはサポートされていません。たとえば、BitLocker ドライブの暗号化を使用する Windows 10 以降のイメージはインポートできません。

この機能には、Linux に対する次の制限があります。

Linux の仮想ディスクは、ブートローダーとして grub を使用する必要があります。
Linux 仮想ディスクは、カスタムイメージと同じ要件を満たしている必要があります。これには、Virtio-SCSI ストレージコントローラデバイスのサポートも含まれます。

この機能には、Windows に対する次の制限があります。

Windows の仮想ディスクにインストールする場合は、Carbon Black の Cb Protection などのアプリケーション許可リストソフトウェアによってインポートプロセスが失敗する可能性があります。インポートする前に、このようなソフトウェアをアンインストールすることが必要になる場合があります。
Windows ベースの VM では、Microsoft KM-TEST Loopback Adapter がメタデータサーバーへのネットワークアクセスを阻止します。インポートする前にこれを無効にするか削除する必要があります。

権限

イメージをシームレスにインポートするには、必要な IAM ロールをアカウント、Cloud Build サービスアカウント、Compute Engine サービスアカウントに付与する必要があります。詳細については、必要な IAM ロールを付与するをご覧ください。

互換性の確認

VM のディスクをインポートする前に、VM 内に事前チェックツールをダウンロードして実行します。事前チェックツールは、インポートプロセスが失敗するか、Compute Engine でディスクが正常に動作しなくなる原因となる可能性がある互換性に関する問題を検出します。

仮想ディスクをインポートする

仮想ディスクは、Google Cloud コンソール、Google Cloud CLI、Cloud Build API のいずれかを使用してインポートできます。

起動可能な仮想ディスクをインポートする

起動可能なディスクの場合、インポートツールがオペレーティングシステムを自動的に検出し、必要なドライバとパッケージを特定するため、オペレーティングシステムを指定する必要はありません。ただし、検出されたオペレーティングシステムをオーバーライドする必要がある場合は、--os フラグまたは -os パラメータを指定します。サポートされている値の一覧については、--os フラグをご覧ください。

コンソール

Google Cloud コンソールで、仮想ディスクファイルを Cloud Storage にアップロードします。
[イメージの作成] ページに移動します。

[イメージの作成] ページに移動
イメージの名前を指定します。
[ソース] で、[仮想ディスク（VMDK、VHD）] を選択します。
Cloud Build サービスアカウントを選択します。デフォルトのサービスアカウントを使用することも、カスタムサービスアカウントを選択することもできます。
- イメージをインポートする権限がないサービスアカウントを選択すると、必要な権限を付与するためのオプションを提示するメッセージが表示されます。[付与] をクリックして、必要な権限をサービスアカウントに付与します。
[ログの場所] に値を入力します。選択したサービスアカウントが Cloud Build サービスアカウントの場合は、ログの場所を指定する必要はありません。その他すべてのサービスアカウント（デフォルトの Compute Engine サービスアカウントを含む）の場合は、ログの場所を指定する必要があります。
Cloud Storage ファイルのストレージの場所を参照するか、手動で入力します。
インポートされたディスクで使用できるオペレーティングシステムを選択します。次のように変更することもできます。
- ゲストパッケージをインストールすることを選択できます。ゲスト環境をインストールすることをおすすめします。ゲスト環境について詳しくは、ゲスト環境をご覧ください。
- Windows または Red Hat Enterprise Linux（RHEL）オペレーティングシステムの場合、ライセンスオプションも選択できます。Compute Engine にライセンスの提供を許可することも、お客様所有ライセンスの使用も可能です。Windows での BYOL について詳しくは、お客様所有ライセンスの使用をご覧ください。
（オプション）イメージの追加プロパティを指定します。たとえば、このイメージをイメージファミリーの一部として管理できます。
[作成] をクリックしてイメージをインポートします。

gcloud

gcloud compute images import コマンドを使用して、起動可能な Compute Engine イメージを作成します。Compute Engine ではほとんどのブートディスクイメージを起動できますが、import コマンドを使用すると、必要なドライバと最新のゲスト環境パッケージが必ずディスクに収められます。これらは、インスタンスを起動して SSH や RDP で接続する際に必要になります。

仮想ディスクファイルは、Cloud Storage バケットまたはローカルワークステーションからインポートできます。

ワークステーションから仮想ディスクファイルをインポートする場合、インポートツールによってファイルが Cloud Storage バケットに自動的にアップロードされます。

インポートプロセスを開始する前に、仮想ディスクファイルを手動で Cloud Storage にアップロードすることもできますが、インポートプロセスで使用されるのと同じプロジェクト内の Cloud Storage バケットにファイルをアップロードする必要があります。

gcloud compute images import IMAGE_NAME \
    --source-file SOURCE_FILE

次のように置き換えます。

IMAGE_NAME: 対象イメージの名前。
SOURCE_FILE: 仮想ディスクファイル。このファイルは、ローカルファイルまたは Cloud Storage に保存されているファイルでもかまいません。仮想ディスクがローカルファイルの場合は、絶対パスまたは相対パスを使用できます。仮想ディスクファイルがすでに Cloud Storage に保存されている場合は、インポートプロセスに使用されるプロジェクトの Cloud Storage バケットにそのファイルが存在する必要があります。また、gs://BUCKET_NAME/OBJECT_NAME の形式でファイルのフルパスを指定する必要があります。

既存のライセンスを使用してイメージをインポートする場合は、--byol フラグを指定します。

gcloud compute images import IMAGE_NAME \
    --source-file SOURCE_FILE --byol

既存のライセンスを含むイメージを Google Cloud にインポートする方法については、お客様所有ライセンスの使用をご覧ください。

ローカルファイルを指定すると、仮想ディスクのサイズやネットワーク接続の速度によって、アップロードオペレーションに長時間かかることがあります。インポートオペレーションは、ディスクのサイズによって数十分かかることがあります。

例

次の例では、gs://your_gcs_bucket に保存されている my_server.vmdk という名前の仮想ディスクをインポートします。

gcloud compute images import my-imported-image \
    --source-file gs://your_gcs_bucket/my_server.vmdk

オプションパラメータ

デフォルトでは、インポートされたすべてのブートディスクイメージにゲスト環境パッケージが追加されます。これらのパッケージが不要な場合は、インポートコマンドに --no-guest-environment フラグを追加してください。

REST

仮想ディスクを Cloud Storage に追加します。

POST リクエストを Cloud Build API に送信します。

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。

POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
 "steps":[
   {
     "args":[
       "-image_name=IMAGE_NAME",
       "-source_file=SOURCE_FILE",
       "-timeout=7000s",
       "-client_id=api"
     ],
     "name":"gcr.io/compute-image-import/gce_vm_image_import:release",
     "env":[
       "BUILD_ID=$BUILD_ID"
     ]
   }
 ],
 "timeout":"7200s",
 "tags":[
   "gce-daisy",
   "gce-daisy-image-import"
 ]
}

次のように置き換えます。

PROJECT_ID: イメージのインポート先のプロジェクトのプロジェクト ID。
IMAGE_NAME: インポートするイメージの名前。
SOURCE_FILE: Cloud Storage 内のイメージの URI（たとえば、gs://my-bucket/my-image.vmdk）。

提供できる追加の args 値については、VM イメージのインポートに関する GitHub ページのオプションのフラグに関するセクションをご覧ください。

レスポンスの例

次のレスポンスのサンプルは、返される出力に似ています。

{
 "name": "operations/build/myproject-12345/operation-1578608233418",
 "metadata": {
  "@type": "type.googleapis.com/google.devtools.cloudbuild.v1.BuildOperationMetadata",
  "build": {
   "id": "3a2055bc-ccbd-4101-9434-d376b88b8940",
   "status": "QUEUED",
   "createTime": "2019-09-20T15:55:29.353258929Z",
   "steps": [
    {
     "name": "gcr.io/compute-image-import/gce_vm_image_import:release",
     "env": [
      "BUILD_ID=3a2055bc-ccbd-4101-9434-d376b88b8940"
     ],
     "args": [
      "-timeout=7000s",
      "-image_name=my-image",
      "-client_id=api",
      "-data-disk",
      "-source_file=gs://my-bucket/my-image.vmdk"
     ]
    }
   ],
   "timeout": "7200s",
   "projectId": "myproject-12345",
   "logsBucket": "gs://123456.cloudbuild-logs.googleusercontent.com",
   "options": {
    "logging": "LEGACY"
   },
   "logUrl": "https://console.cloud.google.com/cloud-build/builds/3a2055bc-ccbd-4101-9434-d376b88b8940?project=123456"
  }
}

ビルドをモニタリングする方法はいくつかあります。

返される build-id を使用して、projects.builds.get リクエストを実行します。
指定された logUrl でホストされているログを確認します。

ライセンスをインポートして仮想ディスクに追加する

イメージのインポート時にライセンスを追加するには、次の gcloud compute images import コマンドを使用します。

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

次のように置き換えます。

IMAGE_NAME: 作成するイメージの名前。
SOURCE_FILE: インポートする仮想ディスクのローカルファイルまたは Cloud Storage URI。
OS: インポートするディスクイメージの OS。OS のライセンスは、このフラグの値から推定されます。インポート時にライセンス情報を提供するための明示的なフラグはありません。サポートされている値の一覧については、--os フラグをご覧ください。

ライセンスの表示と追加の詳細については、ライセンスを表示、追加するをご覧ください。

起動できない仮想ディスクをインポートする

コンソール

Google Cloud コンソールで、仮想ディスクファイルを Cloud Storage にアップロードします。
[イメージの作成] ページに移動します。

[イメージの作成] ページに移動
イメージの名前を指定します。
[ソース] で、[仮想ディスク（VMDK、VHD）] を選択します。
Cloud Storage ファイルのストレージの場所を参照するか、手動で入力します。
オペレーティングシステムについて、[オペレーティングシステムなし。データのみ。] を選択します。
（オプション）イメージの追加プロパティを指定します。たとえば、このイメージをイメージファミリーの一部として管理できます。
[作成] をクリックしてイメージをインポートします。

gcloud

gcloud compute images import コマンドを使用して、非起動の Compute Engine イメージを作成できます。仮想ディスクに起動可能なオペレーティングシステムがインストールされていない場合は、--data-disk フラグを指定します。これにより、Compute Engine でイメージを起動するためにドライバとゲスト環境パッケージをインストールする手順がスキップされます。

gcloud compute images import IMAGE_NAME \
    --source-file SOURCE_FILE \
    --data-disk

次のように置き換えます。

IMAGE_NAME: 対象イメージの名前。
SOURCE_FILE: 仮想ディスクファイル。このファイルは、ローカルファイルまたは Cloud Storage に保存されているファイルでもかまいません。仮想ディスクがローカルファイルの場合は、絶対パスまたは相対パスを使用できます。仮想ディスクファイルがすでに Cloud Storage に保存されている場合は、インポートプロセスに使用されるプロジェクトの Cloud Storage バケットにそのファイルが存在する必要があります。また、gs://BUCKET_NAME/OBJECT_NAME の形式でファイルの完全なパスを指定する必要があります。

例 1: 起動不可能な仮想ディスクを Cloud Storage からインポートする

次の例では、gs://your_gcs_bucket に保存されている my_disk.vmdk という名前の仮想ディスクをインポートします。

gcloud compute images import my-imported-image \
    --source-file gs://your_gcs_bucket/my_disk.vmdk
    --data-disk

例 2: タイムアウト値を指定してサイズの大きい VMDK ファイルをインポートする

インポートプロセスのデフォルトのタイムアウト値は 2 時間です。サイズの大きい VMDK ファイルのインポートには、最大で 24 時間かかることがあります。このようなサイズの大きいファイルをインポートするときに --timeout フラグを指定しないと、プロセスは 2 時間後に失敗します。

次の例では、gs://your_gcs_bucket に保存されている my_disk.vmdk という名前の仮想ディスクをインポートします。このインポートのタイムアウト値は 24 時間です。

gcloud compute images import my-imported-image \
    --source-file gs://your_gcs_bucket/my_disk.vmdk
    --data-disk --timeout=24h

REST

仮想ディスクを Cloud Storage に追加します。
POST リクエストを Cloud Build API に送信します。

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。
```
POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
  "steps":[
    {
      "args":[
        "-image_name=IMAGE_NAME",
        "-source_file=SOURCE_FILE",
        "-timeout=7000s",
        "-client_id=api",
        "-data_disk"
      ],
      "name":"gcr.io/compute-image-import/gce_vm_image_import:release",
      "env":[
        "BUILD_ID=$BUILD_ID"
      ]
    }
  ],
  "timeout":"7200s",
  "tags":[
    "gce-daisy",
    "gce-daisy-image-import"
  ]
}
```
次の args 値を置き換えます。
- PROJECT_ID: イメージのインポート先のプロジェクトのプロジェクト ID。
- IMAGE_NAME: インポートするイメージの名前。
- SOURCE_FILE: Cloud Storage 内のイメージの URI（たとえば、gs://my-bucket/my-image.vmdk）。

外部 IP アドレスを許可しないネットワークを使用したディスクのインポート

外部 IP を許可しないネットワークを使用して仮想ディスクをインポートするには、次の手順で操作します。

仮想ディスクを Cloud Storage に追加します。
イメージのインポートプロセスでは、仮想ディスクのオペレーティングシステムにパッケージマネージャーをインストールする必要があります。これらのパッケージマネージャーでは、Google Cloud の外部にあるパッケージリポジトリにリクエストを送信する必要がある場合があります。これらの更新へのアクセスを許可するには、Cloud NAT を構成する必要があります。詳細については、Cloud Router を使用した NAT 構成の作成をご覧ください。
限定公開の Google アクセスを構成します。詳細については、限定公開の Google アクセスの構成をご覧ください。
Google Cloud CLI か REST のいずれかを使用して仮想ディスクをインポートします。

仮想ディスクをインポートすると、プロジェクトに一時的な VM が作成されます。これらの一時的な VM に外部 IP アドレスが割り当てられないようにするには、追加のフラグまたは引数を指定する必要があります。

詳細については、次のタブをクリックしてください。

gcloud

仮想ディスクをインポートするには、--no-address フラグを指定して gcloud compute images import コマンドを使用します。

gcloud compute images import IMAGE_NAME \
    --source-file=SOURCE_FILE \
    --zone=ZONE \
    --no-address

次のように置き換えます。

IMAGE_NAME: 作成するディスクイメージの名前。
SOURCE_FILE: 仮想ディスクファイル。ローカルファイルまたは Cloud Storage に保存されているファイルでもかまいません。仮想ディスクがローカルファイルの場合は、絶対パスまたは相対パスを使用できます。仮想ディスクファイルがすでに Cloud Storage に保存されている場合は、インポートプロセスに使用されるプロジェクトの Cloud Storage バケットにそのファイルが存在する必要があります。また、gs://BUCKET_NAME/OBJECT_NAME の形式でファイルのフルパスを指定する必要があります。
ZONE: イメージを作成するゾーン。空のままにすると、プロジェクトのデフォルトゾーンが使用されます。

REST

POST リクエストを Cloud Build API に送信し、-no-external-ip 引数を指定します。

 POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
 {
   "steps":[
     {
       "args":[
         "-image_name=IMAGE_NAME",
         "-source_file=SOURCE_FILE",
         "-zone=ZONE",
         "-no_external_ip",
         "-timeout=7000s",
         "-client_id=api"
       ],
       "name":"gcr.io/compute-image-import/gce_vm_image_import:release",
       "env":[
         "BUILD_ID=$BUILD_ID"
       ]
     }
   ],
   "timeout":"7200s",
   "tags":[
     "gce-daisy",
     "gce-daisy-image-import"
   ]
 }

次のように置き換えます。

PROJECT_ID: イメージのインポート先のプロジェクトのプロジェクト ID。
IMAGE_NAME: インポートするイメージの名前。
SOURCE_FILE: Cloud Storage 内のイメージの URI。例: gs://my-bucket/my-image.vmdk（gcloud compute images import コマンド）
ZONE: イメージを作成するゾーン。空のままにすると、プロジェクトのデフォルトゾーンが使用されます。

UEFI ブートローダーによる仮想ディスクのインポート

ほとんどの仮想ディスクでは、追加のフラグを使用しなくても、Compute Engine は UEFI ブートローダーでディスクを検出して正常にインポートできます。

ただし、次のような場合は、インポート中に UEFI ブートを強制的に実行する必要があります。

イメージのインポートプロセス中に、インポート中の UEFI ブートローダーを検出できない場合。
ディスクがデュアルブート可能で、Hybrid-mbr + UEFI または protection-mbr + UEFI が混在している場合。デュアルブート可能なディスクの場合、インポートはデフォルトで非 UEFI ブートになっている可能性があります。

gcloud

インポートで UEFI ブートを強制的に使用するには、gcloud compute images import コマンドを使います。

gcloud compute images import IMAGE_NAME \
    --source-file=SOURCE_FILE \
    --guest-os-features=UEFI_COMPATIBLE

次のように置き換えます。

IMAGE_NAME: インポートするイメージの名前。
SOURCE_FILE: Cloud Storage 内のイメージの URI（たとえば、gs://my-bucket/my-image.vmdk）。

例

次の例では、gs://my-gcs-bucket/ に保存されている my-disk.vmdk という名前の仮想ディスクをインポートし、UEFI ブートの使用を強制します。

gcloud compute images import my-imported-image \
    --source-file gs://my-gcs-bucket/my-disk.vmdk \
    --guest-os-features=UEFI_COMPATIBLE

REST

インポートでの UEFI ブートの使用を強制するには、Cloud Build API を使用して -uefi_compatible 引数を指定します。その方法は次のとおりです。

仮想ディスクを Cloud Storage に追加します。
POST リクエストを Cloud Build API に送信します。

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。
```
POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
 "steps":[
   {
     "args":[
       "-image_name=IMAGE_NAME",
       "-source_file=SOURCE_FILE",
       "-uefi_compatible",
       "-timeout=7000s",
       "-client_id=api"
     ],
     "name":"gcr.io/compute-image-import/gce_vm_image_import:release",
     "env":[
       "BUILD_ID=$BUILD_ID"
     ]
   }
 ],
 "timeout":"7200s",
 "tags":[
   "gce-daisy",
   "gce-daisy-image-import"
 ]
}
```
次のように置き換えます。
- PROJECT_ID: イメージのインポート先のプロジェクトのプロジェクト ID。
- IMAGE_NAME: インポートするイメージの名前。
- SOURCE_FILE: Cloud Storage 内のイメージの URI（たとえば、gs://my-bucket/my-image.vmdk）。

共有 VPC を使用した仮想ディスクのインポート

共有 VPC を使用する仮想ディスクをインポートする前に、Cloud Build サービスアカウントに compute.networkUser ロールを追加する必要があります。詳細については、Cloud Build サービスアカウントに必要なロールを付与するをご覧ください。

gcloud

仮想ディスクをインポートするには、gcloud compute images import コマンドを使用します。

gcloud compute images import IMAGE_NAME \
    --source-file SOURCE_FILE \
    --project SERVICE_PROJECT_ID \
    --zone ZONE \
    --network NETWORK \
    --subnet SUBNET

次のように置き換えます。

IMAGE_NAME: インポートするイメージの名前。
SOURCE_FILE: 仮想ディスクファイル。ローカルファイルまたは Cloud Storage に保存されているファイルでもかまいません。仮想ディスクがローカルファイルの場合は、絶対パスまたは相対パスを使用できます。仮想ディスクファイルがすでに Cloud Storage に保存されている場合は、インポートプロセスに使用されるプロジェクトの Cloud Storage バケットにそのファイルが存在する必要があります。また、gs://BUCKET_NAME/OBJECT_NAME の形式でファイルのフルパスを指定する必要があります。
SERVICE_PROJECT_ID: イメージをインポートするプロジェクトの ID。
ZONE: イメージをインポートするゾーン。このゾーンはサブネットのリージョンと一致する必要があります。たとえば、SUBNET が us-west1 の場合、インポートゾーンは、us-west1-a、us-west1-b、us-west1-c のいずれかにする必要があります。
NETWORK: 共有 VPC ネットワークへのフルパス。例: projects/HOST_PROJECT_ID/global/networks/VPC_NETWORK_NAME

SUBNET: 共有 VPC サブネットワークへのフルパス。例: projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME

サンプルコマンド

gcloud compute images import example-image \
 --source-file gs://source-bucket/source-file.vmdk \
 --project my-image-project \
 --zone us-west1-c \
 --network projects/my-vpc-project/global/networks/my-shared-vpc \
 --subnet projects/my-vpc-project/regions/us-west1/subnetworks/my-shared-subnet

REST

仮想ディスクを Cloud Storage に追加します。
POST リクエストを Cloud Build API に送信します。

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。
```
POST https://cloudbuild.googleapis.com/v1/projects/SERVICE_PROJECT_ID/builds
{
 "steps":[
   {
     "args":[
       "-image_name=IMAGE_NAME",
       "-source_file=SOURCE_FILE",
       "-zone=ZONE",
       "-network=NETWORK",
       "-subnet=SUBNET",
       "-timeout=7000s",
       "-client_id=api"
     ],
     "name":"gcr.io/compute-image-import/gce_vm_image_import:release",
     "env":[
       "BUILD_ID=$BUILD_ID"
     ]
   }
 ],
 "timeout":"7200s",
 "tags":[
   "gce-daisy",
   "gce-daisy-image-import"
 ]
}
```
次の args 値を置き換えます。
- SERVICE_PROJECT_ID: イメージをインポートするプロジェクトの ID。
- IMAGE_NAME: インポートするイメージの名前。
- SOURCE_FILE: Cloud Storage 内のイメージの URI（たとえば、gs://my-bucket/my-image.vmdk）。
- ZONE: イメージをインポートするゾーン。このゾーンはサブネットのリージョンと一致する必要があります。たとえば、SUBNET が us-west1 の場合、インポートゾーンは、us-west1-a、us-west1-b、us-west1-c のいずれかにする必要があります。
- NETWORK: 共有 VPC ネットワークへのフルパス。例: projects/HOST_PROJECT_ID/global/networks/VPC_NETWORK_NAME
- SUBNET: 共有 VPC サブネットワークへのフルパス。例: projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
注: HOST_PROJECT_ID は、共有 VPC が配置されているプロジェクトの ID です。

カスタム Compute Engine サービスアカウントを使用した仮想ディスクのインポート

イメージのインポート中に、プロジェクトに一時的な仮想マシン（VM）インスタンスが作成されます。これらの一時的な VM 上のイメージインポートツールには認証が必要です。

サービスアカウントは VM に接続されている ID です。サービスアカウントのアクセストークンは、インスタンスメタデータサーバーからアクセスでき、VM 上のイメージインポートツールの認証に使用できます。

デフォルトでは、インポートプロセスには、プロジェクトのデフォルトの Compute Engine サービスエージェントが使用されます。ただし、プロジェクトでデフォルトの Compute Engine サービスアカウントが無効になっている場合や、カスタム Compute Engine サービスアカウントを使用する場合は、サービスアカウントを作成してインポートプロセスで指定する必要があります。

gcloud

仮想ディスクを Cloud Storage に追加します。
サービスアカウントを作成して最小限のロールを割り当てます。サービスアカウントの作成に関する詳細については、サービスアカウントの作成と管理をご覧ください。

少なくとも、指定した Compute Engine サービスアカウントには次のロールが割り当てられている必要があります。
- roles/compute.storageAdmin
- roles/storage.objectViewer
詳細については、Compute Engine サービスアカウントに必要なロールを付与するをご覧ください。
gcloud compute images import を使用してイメージをインポートします。
```
gcloud compute images import IMAGE_NAME \
  --source-file SOURCE_FILE \
  --compute-service-account SERVICE_ACCOUNT_EMAIL
```
次のように置き換えます。
- IMAGE_NAME: 対象イメージの名前。
- SOURCE_FILE: 仮想ディスクファイル。このファイルは、ローカルファイルまたは Cloud Storage に保存されているファイルでもかまいません。仮想ディスクがローカルファイルの場合は、絶対パスまたは相対パスを使用できます。仮想ディスクファイルがすでに Cloud Storage に保存されている場合は、インポートプロセスに使用されるプロジェクトの Cloud Storage バケットにそのファイルが存在する必要があります。また、gs://BUCKET_NAME/OBJECT_NAME の形式でファイルのフルパスを指定する必要があります。
- SERVICE_ACCOUNT_EMAIL: 前のステップで作成した Compute Engine サービスアカウントに関連付けられているメールアドレス。
例

次の例では、メールアドレスが image-export-service-account@proj-12345.iam.gserviceaccount.com のサービスアカウントを使用して、gs://your_gcs_bucket に保存された my_server.vmdk という起動可能な仮想ディスクをインポートしています。
```
gcloud compute images import my-imported-image \
  --source-file gs://your_gcs_bucket/my_server.vmdk \
  --compute-service-account image-export-service-account@proj-12345.iam.gserviceaccount.com
```

REST

仮想ディスクを Cloud Storage に追加します。
サービスアカウントを作成して最小限のロールを割り当てます。サービスアカウントの作成に関する詳細については、サービスアカウントの作成と管理をご覧ください。

少なくとも、指定した Compute Engine サービスアカウントには次のロールが割り当てられている必要があります。
- roles/compute.storageAdmin
- roles/storage.objectViewer
詳細については、Compute Engine サービスアカウントに必要なロールを付与するをご覧ください。
仮想ディスクを Cloud Storage に追加します。
POST リクエストを Cloud Build API に送信します。

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。
```
POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
"steps":[
 {
   "args":[
     "-image_name=IMAGE_NAME",
     "-source_file=SOURCE_FILE",
     "-compute_service_account=SERVICE_ACCOUNT_EMAIL",
     "-timeout=7000s",
     "-client_id=api"
   ],
   "name":"gcr.io/compute-image-import/gce_vm_image_import:release",
   "env":[
     "BUILD_ID=$BUILD_ID"
   ]
 }
],
"timeout":"7200s",
"tags":[
 "gce-daisy",
 "gce-daisy-image-import"
]
}
```
次のように置き換えます。
- PROJECT_ID: イメージのインポート先のプロジェクトのプロジェクト ID。
- IMAGE_NAME: インポートするイメージの名前。
- SOURCE_FILE: Cloud Storage 内のイメージの URI（たとえば、gs://my-bucket/my-image.vmdk）。
- SERVICE_ACCOUNT_EMAIL: 前のステップで作成した Compute Engine サービスアカウントに関連付けられているメールアドレス。

イメージを起動可能にする

起動可能なオペレーティングシステムを搭載していながら必要な Compute Engine ドライバやゲスト環境パッケージがない Compute Engine カスタムイメージがある場合、イメージインポートツールを使用すると、そのイメージを Compute Engine で起動可能にできます。

インポートする新しいディスクを指定する --source-file フラグを使用する代わりに、--source-image フラグを使用して、起動可能にするカスタムイメージを指定します。

gcloud compute images import IMAGE_NAME \
    --source-image SOURCE_IMAGE_NAME

次のように置き換えます。

IMAGE_NAME: 対象イメージの名前。
SOURCE_IMAGE_NAME: ソースイメージの名前。

既存のライセンスを含むイメージを Google Cloud にインポートする方法については、お客様所有ライセンスの使用をご覧ください。

サンプルコマンド

次の例では、my-image という名前の Compute Engine イメージを my-bootable-image という起動可能なイメージに変換します。この例の場合、--os ubuntu-1604 は検出されたオペレーティングシステムをオーバーライドしています。

gcloud compute images import my-bootable-image \
    --source-image my-image \
    --os ubuntu-1604

リソースのクリーンアップ

Cloud Storage に保存されているファイルと Compute Engine のイメージには料金が発生します。インポートツールにより、仮想ディスクファイルが Cloud Storage にインポートされ、Compute Engine のカスタムイメージが 1 つ作成されます。

イメージが正常にインポートされ、Compute Engine インスタンスとして正常に起動することを確認したら、Cloud Storage から仮想ディスクファイルを削除できます。このツールにより、ファイルが Cloud Storage にアップロードされると、そのファイルの URI が出力されます。この URI の形式は gs://BUCKET_NAME/tmpimage/IMAGE_NAME です。

--data-disk フラグを使用してイメージをインポートした後、--source-image フラグを指定して import ツールをもう一度実行してそのイメージを起動可能にしても、最初のイメージはまだ残っています。そのイメージが不要な場合は、削除することを検討してください。--image と --source-image の両方のフラグに同じイメージ名を指定すると、そのイメージは自動的に上書きされるため、それ以上のクリーンアップは不要です。

次のステップ

起動可能なイメージを使用する新しい VM インスタンスを作成する。
プロジェクト間でイメージを共有する。

仮想ディスクをインポートする

始める前に

コンソール

gcloud

REST

サポートされているオペレーティング システム

BYOL と BYOS のサポート

制限事項

権限

互換性の確認

仮想ディスクをインポートする

起動可能な仮想ディスクをインポートする

コンソール

gcloud

REST

ライセンスをインポートして仮想ディスクに追加する

起動できない仮想ディスクをインポートする

コンソール

gcloud

REST

外部 IP アドレスを許可しないネットワークを使用したディスクのインポート

gcloud

REST

UEFI ブートローダーによる仮想ディスクのインポート

gcloud

REST

共有 VPC を使用した仮想ディスクのインポート

gcloud

REST

カスタム Compute Engine サービス アカウントを使用した仮想ディスクのインポート

gcloud

REST

イメージを起動可能にする

リソースのクリーンアップ

次のステップ

サポートされているオペレーティングシステム

カスタム Compute Engine サービスアカウントを使用した仮想ディスクのインポート