סקירה כללית של Virtual Machine Manager API

מנהל המכונות הווירטואליות (VMM) של Google Distributed Cloud (GDC) עם בידוד פיזי משתמש בממשקי API של Kubernetes Resource Model (KRM) בפעולות של המכונות הווירטואליות (VM) ובניהול מחזור החיים שלהן.

משתמשים ב-kubectl CLI עבור ממשקי ה-API של VMM.

נקודת קצה של שירות

ממשקי ה-API של VMM KRM מסופקים בשני חבילות, בהתאם לפריסה אזורית או לפריסה גלובלית.

נקודות הקצה של ה-API של VMM ברמת האזור וברמה הגלובלית הן:

  • 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.

מסמך Discovery

משתמשים בפקודה kubectl proxy כדי לפתוח פרוקסי לשרת ה-API במחשב המקומי. מכאן אפשר לגשת למסמך Discovery באחת מכתובות ה-URL הבאות:

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

דוגמה ל-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.