仮想アプライアンスからマシンイメージをインポートする

マシンイメージを使用すると、Compute Engine で実行される VM インスタンス用に、1 つ以上のディスクからすべての構成、メタデータ、権限、データを取得して格納できます。マシンイメージを使用するタイミングと方法については、マシンイメージをご覧ください。

このドキュメントでは、仮想アプライアンスからマシンイメージをインポートする手順を説明します。

始める前に

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

このページのサンプルをどのように使うかに応じて、タブを選択してください。
gcloud
1. Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。
```
gcloud init
```
  注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
2. デフォルトのリージョンとゾーンを設定します。
REST

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

制限事項

マシンイメージは、プロジェクト間で共有できます。ただし、共有 VPC ネットワークはサポートされていません。
この機能は、VPC Service Controls で保護されているプロジェクトではサポートされていません。
200 TB を超えるディスクがアタッチされているソース VM からマシンイメージを作成することはできません。

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

オペレーティングシステムのサポートについては、オペレーティングシステムの詳細をご覧ください。

マシンイメージをインポートする

仮想アプライアンスからマシンイメージをインポートするには、Google Cloud CLI または REST を使用します。

gcloud

gcloud compute machine-images import コマンドを使用して、仮想アプライアンスからマシンイメージをインポートします。

gcloud compute machine-images import MACHINE_IMAGE_NAME \
    --source-uri=gs:SOURCE_URI \
    --os=OS

以下を置き換えます。

MACHINE_IMAGE_NAME: インポートするマシンイメージの名前。
SOURCE_URI: Cloud Storage 上の OVA ファイルまたは OVF ファイルへのパス。
OS: OVA ファイルのオペレーティングシステム。このフラグはデフォルトで省略可能ですが、必要になる場合もあります。このフラグを指定することをおすすめします。

例

たとえば、次の gcloud コマンドを使用すると、gs://my-bucket ディレクトリに保存されていて、centos-7 を実行する my-ova というソース OVA ファイルから my-machine-image というマシンイメージをインポートできます。

gcloud compute machine-images import my-machine-image  \
    --source-uri=gs://my-bucket/my-ova/ \
    --os=centos-7

REST

仮想アプライアンスを Cloud Storage にアップロードします。
POST リクエストを Cloud Build API に送信します。

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。
```
POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
 "timeout": "7200s",
 "steps":[
   {
     "args":[
       "-machine-image-name=MACHINE_IMAGE_NAME",
       "-ovf-gcs-path=SOURCE_URI",
       "-os=OS",
       "-client-id=api",
       "-timeout=7000s"
     ],
     "name":"gcr.io/compute-image-tools/gce_ovf_import:release",
     "env":[
       "BUILD_ID=$BUILD_ID"
     ]
   }
 ],
 "tags":"gce-ovf-machine-image-import"
}
```
以下を置き換えます。
- PROJECT_ID: OVA ファイルのインポート先にするプロジェクトのプロジェクト ID。
- MACHINE_IMAGE_NAME: インポートするマシンイメージの名前。例: my-machine-image。
- SOURCE_URI: OVA ファイルの URI、または Cloud Storage に保存されている OVF パッケージを含むディレクトリ。例: gs://my-bucket/my-instance.ova。
- OS: OVA ファイルのオペレーティングシステム。例: ubuntu-1604。このフラグはデフォルトで省略可能ですが、必要になる場合もあります。このフラグを指定することをおすすめします。
さらに args 値を指定できます。「Compute Engine OVF import GitHub」ページのオプションフラグに関するセクションをご覧ください。

OVF オーバーライドを使用してマシンイメージをインポートする

カスタム CPU とメモリ

gcloud

OVF ファイルで指定された CPU またはメモリ構成をオーバーライドするには、Google Cloud CLI の手順に沿ってマシンイメージをインポートする際に、--custom-cpu フラグと --custom-memory フラグを指定します。

例

my-machine-image という名前のマシンイメージには、OVF ファイルの設定に適用される次のオーバーライドがあります。

オペレーティングシステム: Ubuntu 1404
CPU: 2 CPUs
メモリ: 2048 MB

これらのオーバーライドを使用して my-machine-image をインポートするには、次のコマンドを実行します。

gcloud compute machine-images import my-machine-image \
    --os=ubuntu-1404 --source-uri=gs://my-bucket/Ubuntu.ova \
    --custom-cpu=2 --custom-memory=2048MB

REST

OVF ファイルで指定された CPU またはメモリ構成をオーバーライドするには、Compute Engine API のステップに従い、マシンイメージをインポートし、-machine-type 引数を指定します。この -machine-type は、使用する事前定義またはカスタムマシンタイプです。

例

my-machine-image という名前のマシンイメージには、OVF ファイルの設定に適用される次のオーバーライドがあります。

オペレーティングシステム: Ubuntu 1404
CPU: 2 CPUs
メモリ: 2048 MB

これらのオーバーライドを使用して my-machine-image をインポートするには、Compute Engine API に次のリクエストを行います。

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

POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
  "timeout":"7200s",
  "steps":[
    {
      "args":[
        "-machine-image-name=my-machine-image",
        "-ovf-gcs-path=gs://my-bucket/Ubuntu.ova",
        "-os=ubuntu-1404",
        "-machine-type=custom-2-2048",
        "-client-id=api",
        "-timeout=7000s"
      ],
      "name":"gcr.io/compute-image-tools/gce_ovf_import:release",
      "env":[
        "BUILD_ID=$BUILD_ID"
      ]
    }
  ],
  "tags":"gce-ovf-machine-image-import"
}

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

カスタムネットワーク

gcloud

カスタムネットワークを設定するには、Google Cloud CLI の手順に沿ってマシンイメージをインポートする際に、--network フラグを指定します。ネットワークがカスタムサブネットモードで構成されている場合は、--subnet フラグと --zone フラグも指定する必要があります。

例

my-machine-image という名前のマシンイメージには、OVF ファイルの設定に適用される次のオーバーライドがあります。

オペレーティングシステム: Ubuntu 1404
ネットワーク: custom-vpc-network
サブネット: company-vpc-us-east1-c
ゾーン: us-east1-c

これらのオーバーライドを使用して my-machine-image をインポートするには、次のサンプルコマンドを実行します。

gcloud compute machine-images import my-machine-image \
    --os=ubuntu-1404 \
    --source-uri=gs://my-bucket/Ubuntu.ova \
    --network=custom-vpc-network \
    --subnet=company-vpc-us-east1-c \
    --zone=us-east1-c

REST

カスタムネットワークを使用するには、Compute Engine API の手順に沿ってマシンイメージをインポートし、-network 引数を指定します。ネットワークがカスタムサブネットモードで構成されている場合は、-subnet 引数と -zone 引数も指定する必要があります。

例

my-machine-image という名前のマシンイメージには、OVF ファイルの設定に適用される次のオーバーライドがあります。

オペレーティングシステム: Ubuntu 1404
ネットワーク: custom-vpc-network
サブネット: company-vpc-us-east1-c
ゾーン: us-central1-c

これらのオーバーライドを使用して my-machine-image をインポートするには、Compute Engine API に次のリクエストを行います。

POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
  "timeout":"7200s",
  "steps":[
    {
      "args":[
        "-machine-image-name=my-machine-image",
        "-ovf-gcs-path=gs://my-bucket/Ubuntu.ova",
        "-os=ubuntu-1404",
        "-zone=us-central1-c",
        "-network=custom-vpc-network",
        "-subnet=company-vpc-us-east1-c",
        "-client-id=api",
        "-timeout=7000s"
      ],
      "name":"gcr.io/compute-image-tools/gce_ovf_import:release",
      "env":[
        "BUILD_ID=$BUsILD_ID"
      ]
    }
  ],
  "tags":"gce-ovf-machine-image-import"
}

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

外部 IP を許可しないネットワーク内にマシンイメージをインポートする

外部 IP アドレスを許可しないネットワークを使用してマシンイメージをインポートするには、次の手順を行います。

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

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

必須フラグや引数の詳細については、次のタブをクリックしてください。

gcloud

--no-address フラグを指定して gcloud compute machine-images import コマンドを使用します。

gcloud compute machine-images import MACHINE_IMAGE_NAME \
    --source-uri=SOURCE_URI \
    --os=OS \
    --zone=ZONE \
    --no-address

以下を置き換えます。

MACHINE_IMAGE_NAME: インポートするマシンイメージの名前。
SOURCE_URI: Cloud Storage 上にある OVA または OVF ファイルの URI。例: gs://my-bucket/Ubuntu.ova。
OS: OVA ファイルのオペレーティングシステム。このフラグはデフォルトで省略可能ですが、必要になる場合もあります。このフラグを指定することをおすすめします。サポートされている値の一覧については、gcloud compute machine-images import コマンドの --os フラグオプションをご覧ください。
ZONE: マシンイメージをインポートするゾーン。空のままにすると、プロジェクトのデフォルトゾーンが使用されます。

REST

Cloud Build API を使用して、-no-external-ip 引数を指定します。

 POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
 {
  "timeout":"7200s",
  "steps":[
    {
      "args":[
        "-machine-image-name=MACHINE_IMAGE_NAME",
        "-ovf-gcs-path=SOURCE_URI",
        "-os=OS",
        "-zone=ZONE",
        "-no-external-ip",
        "-client-id=api",
        "-timeout=7000s"
      ],
      "name":"gcr.io/compute-image-tools/gce_ovf_import:release",
      "env":[
        "BUILD_ID=$BUILD_ID"
      ]
    }
  ],
  "tags":"gce-ovf-machine-image-import"
}

以下を置き換えます。

PROJECT_ID: マシンイメージをインポートするプロジェクトのプロジェクト ID。
MACHINE_IMAGE_NAME: インポートするマシンイメージの名前。例: my-machine-image。
SOURCE_URI: Cloud Storage に保管されている OVA ファイルの URI例: gs://my-bucket/my-machine.ova
OS: OVA ファイルのオペレーティングシステム（ubuntu-1604 など）。このフラグはデフォルトではオプションですが、必要になる場合もあります。このフラグを指定することをおすすめします。サポートされている値の一覧については、gcloud compute instances import コマンドの --os フラグオプションをご覧ください。
ZONE: マシンイメージをインポートするゾーン。

カスタムサービスアカウントを使用してマシンイメージをインポートする

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

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

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

gcloud

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

少なくとも、指定した Compute Engine サービスアカウントには次のロールが割り当てられている必要があります。
- roles/compute.storageAdmin
- roles/storage.objectViewer
これらの最低限必要なロールは、--compute-service-account フラグで指定されるサービスアカウントに必要です。詳細については、Compute Engine サービスアカウントに必要なロールを付与するをご覧ください。
gcloud compute machine-images import コマンドを使用して、仮想アプライアンスからマシンイメージをインポートします。
```
gcloud compute machine-images import MACHINE_IMAGE_NAME \
    --source-uri=gs:SOURCE_URI \
    --os=OS \
    --compute-service-account=TEMP_SERVICE_ACCOUNT_EMAIL \
    --service-account=SERVICE_ACCOUNT_EMAIL \
    --scopes=SCOPES
```
以下を置き換えます。
- MACHINE_IMAGE_NAME: インポートするマシンイメージの名前。
- SOURCE_URI: Cloud Storage 上の OVA ファイルまたは OVF ファイルへのパス。
- OS: OVA ファイルのオペレーティングシステム。このフラグはデフォルトで省略可能ですが、必要になる場合もあります。このフラグを指定することをおすすめします。
- TEMP_SERVICE_ACCOUNT_EMAIL: 前の手順で作成したカスタムサービスアカウントに関連付けられているメールアドレス。このサービスアカウントは一時的な VM によって使用されます。指定しない場合、VM はデフォルトの Compute Engine サービスアカウントを使用します。
- SERVICE_ACCOUNT_EMAIL: このマシンイメージから作成された VM に接続するカスタムサービスアカウントに関連付けられたメールアドレス。このサービスアカウントには権限の制限がないため、必要に応じてカスタマイズできます。指定しない場合は、デフォルトの Compute Engine サービスアカウントが VM に接続されます。
- SCOPES: --service-account オプションのアクセスレベルを指定します。指定しない場合、デフォルトのスコープが使用されます。詳細については、--scopes フラグをご覧ください。

REST

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

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

注: timeout の値は 2 つ必要です。これらのデフォルト値は、次のサンプルリクエストに示されています。デフォルト値は、ほとんどのシナリオで機能します。ただし、これらの値を調整する必要がある場合は、Cloud Build のタイムアウトが、引数（args）セクションで指定されたタイムアウト値より少なくとも 3% 大きいことを確認してください。
```
POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
"timeout":"7200s",
"steps":[
  {
    "args":[
      "-machine-image-name=MACHINE_IMAGE_NAME",
      "-ovf-gcs-path=SOURCE_URI",
      "-os=OS",
      "-zone=ZONE",
      "-compute-service-account=TEMP_SERVICE_ACCOUNT_EMAIL",
      "-service-account=SERVICE_ACCOUNT_EMAIL",
      "-client-id=api",
      "-timeout=7000s"
    ],
    "name":"gcr.io/compute-image-tools/gce_ovf_import:release",
    "env":[
      "BUILD_ID=$BUILD_ID"
    ]
  }
],
"tags":"gce-ovf-machine-image-import"
}
```
以下を置き換えます。
- PROJECT_ID: マシンイメージをインポートするプロジェクトのプロジェクト ID。
- MACHINE_IMAGE_NAME: インポートするマシンイメージの名前。例: my-machine-image。
- SOURCE_URI: Cloud Storage に保管されている OVA ファイルの URI例: gs://my-bucket/my-machine.ova
- OS: OVA ファイルのオペレーティングシステム（ubuntu-1604 など）。このフラグはデフォルトではオプションですが、必要になる場合もあります。このフラグを指定することをおすすめします。サポートされている値の一覧については、gcloud compute instances import コマンドの --os フラグオプションをご覧ください。
- ZONE: マシンイメージをインポートするゾーン。
- TEMP_SERVICE_ACCOUNT_EMAIL: 前の手順で作成したカスタムサービスアカウントに関連付けられているメールアドレス。このサービスアカウントは一時的な VM によって使用されます。指定しない場合、VM はデフォルトの Compute Engine サービスアカウントを使用します。
- SERVICE_ACCOUNT_EMAIL: このマシンイメージから作成された VM に接続するカスタムサービスアカウントに関連付けられたメールアドレス。このサービスアカウントには権限の制限がないため、必要に応じてカスタマイズできます。指定しない場合は、デフォルトの Compute Engine サービスアカウントが VM に接続されます。
- SCOPES: --service-account オプションのアクセスレベルを指定します。指定しない場合、デフォルトのスコープが使用されます。詳細については、--scopes フラグをご覧ください。

次のステップ

マシンイメージの詳細を確認する
マシンイメージから VM インスタンスを作成する

仮想アプライアンスからマシンイメージをインポートする

始める前に

gcloud

REST

制限事項

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

マシンイメージをインポートする

gcloud

REST

OVF オーバーライドを使用してマシンイメージをインポートする

カスタム CPU とメモリ

gcloud

REST

カスタム ネットワーク

gcloud

REST

外部 IP を許可しないネットワーク内にマシンイメージをインポートする

gcloud

REST

カスタム サービス アカウントを使用してマシンイメージをインポートする

gcloud

REST

次のステップ

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

カスタムネットワーク

カスタムサービスアカウントを使用してマシンイメージをインポートする