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

このドキュメントでは、仮想マシン（VM）ディスクイメージを Google Distributed Cloud（GDC）にエアギャップでインポートする手順について説明します。

既存の仮想ディスク（ゴールデンディスクまたはゴールデンイメージと呼ばれることが多い）を Distributed Cloud にインポートして時間を節約し、生成されたイメージを使用して仮想マシンを作成します。インポートツールは、RAW と QCOW のイメージ形式をサポートしています。

このドキュメントは、VM イメージを作成するプラットフォーム管理者またはアプリケーションオペレーターグループの開発者を対象としています。詳細については、GDC エアギャップの対象読者に関するドキュメントをご覧ください。

始める前に

続行する前に、次のことを確認してください。

gdcloud CLI がダウンロード、インストール、構成されている。GDC のすべての CLI コマンドは gdcloud または kubectl CLI を使用し、オペレーティングシステム（OS）環境が必要です。

権限とアクセス権をリクエストする

イメージをインポートして、このページに記載されている VM オペレーションを実行するには、VM が存在するプロジェクトの Namespace で次の IAM ロールを付与するよう、プロジェクト IAM 管理者に依頼してください。

プロジェクト VirtualMachine 管理者（project-vm-admin）: プロジェクト Namespace の VM を管理します。
プロジェクト閲覧者（project-viewer）: プロジェクト Namespace 内のすべてのリソースに対する読み取り専用アクセス権があります。

手順に沿ってアクセスを確認します。

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

仮想ディスクファイルは、ワークステーションから直接インポートできます。インポートツールは、ファイルをプロジェクトのオブジェクトストレージバケットに自動的にアップロードします。

仮想ディスクをインポートするには、gdcloud CLI または Virtual Machine Manager API を使用します。

gdcloud

import コマンドは、セキュアシェル（SSH）とリモートデスクトッププロトコル（RDP）を使用してインスタンスに接続するための認証情報を構成するために必要なパッケージがディスクにあることを確認します。これにはゲスト環境が含まれます。

このコマンドは、GDC でインスタンスが適切に実行されるように、ネットワークタイムプロトコル（NTP）と cloud-init のパッケージもインストールします。

起動可能なイメージを作成するには、gdcloud compute images import コマンドを使用します。

gdcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE \
  --os=IMAGE_OS \
  --timeout=TIMEOUT

次の変数を置き換えます。

IMAGE_NAME: 対象イメージの名前。名前は 35 文字以下にする必要があります。
SOURCE_FILE: 仮想ディスクファイル。このファイルはワークステーションのローカルファイルです。絶対パスまたは相対パスを指定できます。
IMAGE_OS: インポートするディスクの OS。
TIMEOUT: インポートが「TIMEOUT」で失敗するまでの時間。たとえば、2h を指定すると、プロセスは 2 時間後に失敗します。デフォルトのタイムアウトは 1h です。

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

API

API を使用して仮想ディスクをインポートする手順は次のとおりです。

Management API サーバーに VirtualMachineImageImport オブジェクトを作成して、イメージのインポートプロセスを開始します。
```
kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT_ID \
  apply -f - <<EOF
apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineImageImport
metadata:
  name: IMAGE_NAME
  namespace: PROJECT_ID
spec:
  source:
    objectStorage:
      bucketRef:
        name: vm-images-bucket
      objectName: SOURCE_FILE
  imageMetadata:
    name: IMAGE_NAME
    operatingSystem: IMAGE_OS
    minimumDiskSize: DISK_SIZE
EOF
```
次の変数を置き換えます。
- IMAGE_NAME: インポートするイメージの名前。名前は 35 文字以下にする必要があります。
- PROJECT_ID: イメージをインポートするプロジェクトのプロジェクト ID。
- SOURCE_FILE: オブジェクトストレージへの仮想ディスクのアップロードを含むソースファイルの名前。この値は、vm-images-bucket/ の後のオブジェクトストレージパスのセクションです。
- IMAGE_OS: インポートするディスクの OS。
- DISK_SIZE: このイメージで作成されるディスクの最小サイズ。元のイメージのファイルシステムサイズに 20% 以上のバッファを使用します。たとえば、元のファイルシステムのサイズが 10G の仮想ディスクには、少なくとも 12G を使用します。

VirtualMachineImageImport オブジェクトのステータスをクエリして、インポートの進行状況をモニタリングします。

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT_ID \
  get virtualmachineimageimport.virtualmachine.gdc.goog IMAGE_NAME \
  -o jsonpath='{.status}'

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

インポートプロセスでは、仮想ディスクファイルをオブジェクトストレージにアップロードします。gdcloud CLI を使用する場合、コマンドが成功したかどうかにかかわらず、コマンドが完了するとオブジェクトはクリーンアップされます。コマンドが中断された場合、または API を使用してイメージのインポートを実行した場合、仮想ディスクファイルは、手動でファイルを削除するまで、vm-images-bucket という名前のオブジェクトストレージバケットに残る可能性があります。

仮想ディスクをインポートする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

権限とアクセス権をリクエストする

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

gdcloud

API

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

次のステップ

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