Présentation de l'API Virtual Machine Manager

Le gestionnaire de machines virtuelles (VMM) de Google Distributed Cloud (GDC) air-gapped utilise les API Kubernetes Resource Model (KRM) dans ses opérations de machines virtuelles (VM) et la gestion du cycle de vie.

Utilisez la CLI kubectl pour les API VMM.

Point de terminaison de service

Les API KRM VMM sont fournies dans deux packages en fonction du déploiement zonal ou global.

Voici les points de terminaison de l'API VMM zonale et globale :

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

La variable MANAGEMENT_API_SERVER_ENDPOINT est le point de terminaison du serveur de l'API Management.

Document de découverte

Utilisez la commande kubectl proxy pour ouvrir un proxy vers le serveur d'API sur votre machine locale. Vous pouvez ensuite accéder au document de découverte à l'une des URL suivantes :

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

Exemple de KRM de VM

Le fichier VirtualMachineImageImport suivant montre la création d'une image de disque à partir d'un disque persistant. Vous choisissez le disque persistant dans une liste VirtualMachineDisk et le sélectionnez pour créer l'image et obtenir le paramètre size de la source. Le même exemple est disponible sur la page Créer des images personnalisées.

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.