Virtual Machine Manager API の概要

Google Distributed Cloud（GDC）エアギャップの仮想マシン マネージャー（VMM）は、仮想マシン（VM）のオペレーションとライフサイクル管理で Kubernetes Resource Model（KRM）API を使用します。

VMM API には kubectl CLI を使用します。

サービス エンドポイント

VMM KRM API は、ゾーンデプロイまたはグローバル デプロイに応じて 2 つのパッケージで提供されます。

ゾーン VMM API とグローバル VMM API の API エンドポイントは、それぞれ次のとおりです。

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/virtualmachine.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/virtualmachine.global.gdc.goog/v1

MANAGEMENT_API_SERVER_ENDPOINT 変数は、Management API サーバーのエンドポイントです。

ディスカバリ ドキュメント

kubectl proxy コマンドを使用して、ローカルマシン上の API サーバーへのプロキシを開きます。そこから、次のいずれかの URL でディスカバリ ドキュメントにアクセスできます。

  • http://127.0.0.1:8001/apis/virtualmachine.gdc.goog/v1
  • http://127.0.0.1:8001/apis/virtualmachine.global.gdc.goog/v1

VM KRM の例

次の VirtualMachineImageImport ファイルは、永続ディスクからディスク イメージを作成する方法を示しています。VirtualMachineDisk リストから永続ディスクを選択してイメージを作成し、ソースの size パラメータを取得します。同じ例が カスタム イメージを作成する ページにあります。

apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineImageImport
metadata:
  name: VM_IMAGE_IMPORT_NAME
  # Name of the VM image you want to import.
spec:
  source:
    diskRef:
      name: DISK_NAME
      # Name of the source disk that you will use to create your image.
  imageMetadata:
    name: IMAGE_NAME
    # Name of your created VM image.
    operatingSystem: OS_NAME
    # Name of the image OS.
    minimumDiskSize: MINIMUM_DISK_SIZE
    # Disk size in the VM image. It must be greater than or equal to the source disk size. An example value is 20G.