Créer et gérer des disques virtuels dans Google Distributed Cloud

Ce document est destiné aux propriétaires d'applications qui exécutent Google Distributed Cloud. Ce document explique comment créer et gérer des ressources de disque pour les machines virtuelles (VM) qui utilisent l'environnement d'exécution des VM sur GDC.

Avant de commencer

Pour suivre les instructions de ce document, vous devez disposer des ressources suivantes :

Créer une VM avec un disque associé

Lorsque vous créez une VM, vous pouvez associer un disque de démarrage ou de données existant, créer un disque à partir d'une image (y compris pour le disque de démarrage) ou créer un disque vide.

Disque vide

Dans ce scénario, vous créez un disque vide et vous l'associez à la VM. Ce scénario vous permet de créer un disque de données afin de stocker les données de votre application.

  1. Dans l'éditeur de votre choix, créez un fichier manifeste qui définit un VirtualMachineDisk et une VirtualMachine, tel que my-vm.yaml :

    nano my-vm.yaml
    
  2. Copiez et collez la définition YAML suivante :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: DISK_NAME
    spec:
      size: 10Gi
    ---
    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      name: VM_NAME
    spec:
      interfaces:
        - name: eth0
          networkName: pod-network
          default: true
      disks:
        - boot: true
          virtualMachineDiskName: VM_NAME-boot-dv
        - virtualMachineDiskName: DISK_NAME
    

    Remplacez les éléments suivants :

    • DISK_NAME: nom du disque vide que vous créez et associez à votre VM.

    • VM_NAME: nom de la VM que vous créez.

      Cet exemple crée un disque vide 10Gi (10 gibioctets) nommé DISK_NAME. Dans la section spec.disks de la VM, vous devez également associer un disque de démarrage, par exemple à partir d'une image, comme illustré dans la section suivante.

  3. Enregistrez et fermez le fichier manifeste dans l'éditeur.

  4. Créez la VM et le disque en utilisant kubectl :

    kubectl apply -f my-vm.yaml --kubeconfig KUBECONFIG
    

    Remplacez KUBECONFIG par le chemin d'accès au fichier kubeconfig du cluster.

À partir de l'image

Dans ce scénario, vous créez un disque à partir d'une image et vous l'associez à la VM. Ce scénario vous permet de créer un disque de démarrage, par exemple à partir d'une image. Vous pouvez également créer et associer des disques de données à partir d'une image.

Sources d'images compatibles

L'environnement d'exécution des VM sur GDC accepte différents formats d'image et accepte trois types de sources d'images qui peuvent être spécifiés dans la spécification VirtualMachineDisk. Chacun des exemples suivants crée un disque de 20 gibioctets à partir d'une autre source d'images compatible.

  • Protocole de transfert Hypertext (HTTP)

    L'exemple VirtualMachineDisk suivant montre la structure de base d'une source d'image HTTP. Le champ url attend une URL HTTP ou HTTPS.

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: my-disk
    spec:
      source:
        http:
          url: https://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img
      size: 20GiB
      storageClassName: local-shared
    
  • Cloud Storage

    L'exemple suivant montre comment créer un disque à partir d'une image stockée dans un bucket Cloud Storage. Si les identifiants par défaut de l'application sur la machine ne sont pas suffisants pour accéder à l'URL Cloud Storage, vous devez en fournir. Dans l'exemple suivant, my-gcs est un secret contenant une clé de compte de service encodée en base64.

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: my-disk
    spec:
      source:
        gcs:
          url: gs://kubevirt-ci-vm-images/rhel8.2/rhel8_2_cloud.qcow2
          secretRef: my-gcs
      size: 20GiB
      storageClassName: local-shared
    

    Si vous avez utilisé des clés de compte de service téléchargées pour créer votre cluster, vous pouvez utiliser la clé de compte de service Container Registry pour un accès Cloud Storage. Si vous créez un compte de service distinct pour accéder à Cloud Storage, consultez la section Configurer un compte de service pouvant accéder à un bucket Cloud Storage.

    Utilisez la commande suivante pour créer un secret Kubernetes à partir du fichier de clé de compte de service téléchargé :

    kubectl create secret generic SECRET_NAME --from-file=KEY_FILE --namespace default \
        --kubeconfig KUBECONFIG
    

    Remplacez les éléments suivants :

    • SECRET_NAME: nom de votre secret.
    • KEY_FILE: chemin d'accès au fichier JSON de clé de compte de service téléchargé. Exemple :bmctl-workspace/.sa-keys/my-project-anthos-baremetal-gcr.json
    • KUBECONFIG: chemin d'accès au fichier kubeconfig du cluster.

    Pour en savoir plus sur l'utilisation des identifiants pour accéder à Cloud Storage, consultez la page Créer et utiliser des identifiants pour importer des images à partir de Cloud Storage.

  • Exemple Container Registry

    Les registres de conteneurs conformes à la distribution-spec de l'Open Container Initiative (OCI) sont disponibles. L'exemple suivant crée un disque à partir d'une image stockée dans un registre Docker.

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: my-disk
    spec:
      source:
        registry:
          url: docker://kubevirt/fedora-cloud-registry-disk-demo
      size: 20GiB
      storageClassName: local-shared
    

Formats d'image valides

Vous pouvez utiliser l'un des formats d'image suivants lorsque vous créez un disque à partir d'une image:

  • Archive GNU ZIP (gzip) (.gz)
  • RAW (.raw, .img)
  • Copie QEMU sur l'image disque (écriture version 2) (qcow2) (.qcow2)
  • Archive compressée au format XZ (.xz)
  • Fichier de disque de machine virtuelle (VMDK) (.vmdk)
  • Fichier VDI (VirtualBox Virtual Disk Image) (.vdi)
  • Fichier d'image de disque dur virtuel (VHD) (.vdh)
  • Fichier de disque dur virtuel version 2 (VDHX) (.vdhx)
  • Fichier image de disque ISO (.iso)

Exemple de disque créé à partir d'une image HTTP

La procédure suivante permet de créer un disque de démarrage à partir d'une image Ubuntu:

  1. Créez un fichier manifeste définissant des fichiers VirtualMachineDisk et VirtualMachine (my-vm.yaml,, par exemple) dans l'éditeur de votre choix :

    nano my-vm.yaml
    
  2. Copiez et collez la définition YAML suivante :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: VM_NAME-boot-dv
    spec:
      size: 20Gi
      source:
        http:
          url: https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64.img
    ---
    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      name: VM_NAME
    spec:
      interfaces:
        - name: eth0
          networkName: pod-network
          default: true
      disks:
        - boot: true
          virtualMachineDiskName: VM_NAME-boot-dv
    

    Cet exemple crée un disque 20Gi (20 gibioctets) nommé VM_NAME-boot-dv à l'aide d'une image Ubuntu publique. Dans la section spec.disks de la VM, le disque est défini sur boot: true.

  3. Enregistrez et fermez le fichier manifeste dans votre éditeur.

  4. Créez la VM et le disque en utilisant kubectl :

    kubectl apply -f my-vm.yaml --kubeconfig KUBECONFIG
    

    Remplacez KUBECONFIG par le chemin d'accès au fichier kubeconfig du cluster.

Disque existant

Dans ce scénario, vous créez un disque vide et vous l'associez à la VM. Ce scénario vous permet de créer un disque de données afin de stocker les données de votre application.

  1. Créez un fichier manifeste VirtualMachine (my-vm.yaml,, par exemple) dans l'éditeur de votre choix :

    nano my-vm.yaml
    
  2. Copiez et collez la définition YAML suivante :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      name: VM_NAME
    spec:
      interfaces:
        - name: eth0
          networkName: pod-network
          default: true
      disks:
        - boot: true
          virtualMachineDiskName: VM_NAME-boot-dv
        - virtualMachineDiskName: EXISTING_DISK_NAME
    

    Cet exemple associe un disque existant nommé EXISTING_DISK_NAME.

    Dans la section spec.disks de la VM, vous devez également associer un disque de démarrage, par exemple à partir d'une image, comme illustré dans la section précédente.

  3. Enregistrez et fermez le fichier manifeste de la VM dans votre éditeur.

  4. Créez la VM en utilisant kubectl :

    kubectl apply -f my-vm.yaml --kubeconfig KUBECONFIG
    

    Remplacez KUBECONFIG par le chemin d'accès au fichier kubeconfig du cluster.

Localiser les disques

À partir de la version 1.13.0 de Google Distributed Cloud, lorsque vous créez une VM, l'environnement d'exécution de VM sur GDC utilise les noms de disque que vous spécifiez dans la ressource de VM pour définir les numéros de série des disques. Plus précisément, les noms que vous spécifiez avec spec.disks.virtualMachineDiskName dans la ressource personnalisée VirtualMachine sont utilisés dans le numéro de série des disques. Cette fonctionnalité facilite la localisation des disques dans la VM lorsque vous devez effectuer des opérations sur les disques, telles que la mise en forme ou l'installation.

Par exemple, si vous avez créé une VM et spécifié un disque de démarrage nommé sample-boot-dv, votre ressource personnalisée VirtualMachine ressemble à ceci:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: sample-vm
spec:
  osType: Linux
  compute:
    cpu:
      vcpus: 2
    memory:
      capacity: 4Gi
  interfaces:
    - name: eth0
      networkName: pod-network
      default: true
  disks:
    - boot: true
      virtualMachineDiskName: sample-vm-boot-dv
    - virtualMachineDiskName: attached-disk

Pour les VM Linux, lorsque vous vous connectez à votre VM, vous pouvez exécuter la commande suivante pour répertorier les disques par leur numéro de série:

ls -l /dev/disk/by-id/

Votre réponse doit ressembler à cet exemple de résultat, où les noms des disques apparaissent sous forme de numéros de série:

total 0
lrwxrwxrwx 1 root root  9 Oct 19 17:17 ata-QEMU_HARDDISK_agentInstallation -> ../../sdb
lrwxrwxrwx 1 root root  9 Oct 19 17:17 ata-QEMU_HARDDISK_agentSADisk -> ../../sda
lrwxrwxrwx 1 root root  9 Oct 19 17:17 virtio-sample-boot-dv -> ../../vda
lrwxrwxrwx 1 root root 10 Oct 19 17:17 virtio-sample-boot-dv-part1 -> ../../vda1
lrwxrwxrwx 1 root root 11 Oct 19 17:17 virtio-sample-boot-dv-part14 -> ../../vda14
lrwxrwxrwx 1 root root 11 Oct 19 17:17 virtio-sample-boot-dv-part15 -> ../../vda15
lrwxrwxrwx 1 root root 11 Oct 19 17:17 virtio-attached-disk -> ../../vdb

Observez le comportement de la situation suivante:

  • Si la valeur virtualMachineDiskName comporte plus de 20 caractères, l'environnement d'exécution de VM sur GDC n'utilise que les 20 premiers caractères comme numéro de série.
  • S'il existe deux disques avec les mêmes 20 premiers caractères, seul le premier disque possède un numéro de série.

Créer et associer des disques à une VM existante

Si vous disposez déjà d'une VM, vous pouvez créer et associer des disques pour gérer le cycle de vie de votre application. La VM doit être arrêtée pour pouvoir lui associer un disque.

Disque vide

Dans ce scénario, vous créez un disque vide et vous l'associez à la VM. Ce scénario vous permet de créer un disque de données afin de stocker les données de votre application.

  1. Utilisez kubectl pour arrêter la VM, si nécessaire :

    kubectl virt stop vm VM_NAME --kubeconfig KUBECONFIG
    

    Remplacez les éléments suivants :

    • VM_NAME : nom de la VM que vous souhaitez mettre arrêter.
    • KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster.
  2. Modifiez la ressource de VM existante, telle que my-vm :

    kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG
    
  3. Mettez à jour le fichier manifeste VirtualMachine pour ajouter une section VirtualMachineDisk en haut, puis associez le disque à la fin de la section spec.disks de la VM :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: DISK_NAME
    spec:
      size: 10Gi
    ---
    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      name: VM_NAME
    spec:
      interfaces:
        - name: eth0
          networkName: pod-network
          default: true
      disks:
        - boot: true
          virtualMachineDiskName: VM_NAME-boot-dv
        - virtualMachineDiskName: DISK_NAME
    

    Cet exemple crée un disque vide 10Gi (10 gibioctets) nommé DISK_NAME.

  4. Enregistrez et fermez le fichier manifeste mis à jour de la VM dans votre éditeur.

  5. Utilisez kubectl pour démarrer la VM :

    kubectl virt start vm VM_NAME --kubeconfig KUBECONFIG
    

À partir de l'image

Dans ce scénario, vous créez un disque à partir d'une image source et vous l'associez à la VM.

  1. Utilisez kubectl pour arrêter la VM, si nécessaire :

    kubectl virt stop vm VM_NAME --kubeconfig KUBECONFIG
    

    Remplacez les éléments suivants :

    • VM_NAME : nom de la VM que vous souhaitez mettre arrêter.
    • KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster.
  2. Modifiez la ressource de VM existante, telle que my-vm :

    kubectl edit gvm VM_NAME --kubeconfig KUBECONFIG
    
  3. Mettez à jour le fichier manifeste VirtualMachine pour ajouter une section VirtualMachineDisk en haut, puis associez le disque à la fin de la section spec.disks de la VM :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: DISK_NAME
    spec:
      size: 10Gi
      source:
        http:
          url: http://example.com/my-disk-img.qcow2
    ---
    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachine
    metadata:
      name: VM_NAME
    spec:
      interfaces:
        - name: eth0
          networkName: pod-network
          default: true
      disks:
        - boot: true
          virtualMachineDiskName: VM_NAME-boot-dv
        - virtualMachineDiskName: DISK_NAME
    

    Cet exemple crée un disque 10Gi (10 gibioctets) nommé DISK_NAME à partir de la source HTTP http://example.com/my-disk-img.qcow2.

  4. Enregistrez et fermez le fichier manifeste mis à jour de la VM dans votre éditeur.

  5. Utilisez kubectl pour démarrer la VM :

    kubectl virt start vm VM_NAME --kubeconfig KUBECONFIG
    

Créer un disque

Dans ce scénario, vous créez les ressources de disque séparément des ressources de VM. Ce scénario vous permet de créer des disques à l'avance, puis de les associer à des VM au besoin.

Disque vide

Pour créer un disque vide, procédez comme suit :

  1. Créez un fichier manifeste VirtualMachineDisk (my-disk.yaml,, par exemple) dans l'éditeur de votre choix :

    nano my-disk.yaml
    
  2. Copiez et collez la définition YAML suivante :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: DISK_NAME
    spec:
      size: 10Gi
    

    Cet exemple crée un disque vide 10Gi (10 gibioctets) nommé DISK_NAME.

  3. Enregistrez et fermez le fichier manifeste de disque dans votre éditeur.

  4. Créez le disque en utilisant kubectl :

    kubectl apply -f my-disk.yaml --kubeconfig KUBECONFIG
    

    Remplacez KUBECONFIG par le chemin d'accès au fichier kubeconfig du cluster.

À partir de l'image

Pour créer un disque à partir d'une image, procédez comme suit :

  1. Créez un fichier manifeste VirtualMachineDisk, tel que my-disk.yaml, dans l'éditeur de votre choix :

    nano my-disk.yaml
    
  2. Copiez et collez la définition YAML suivante :

    apiVersion: vm.cluster.gke.io/v1
    kind: VirtualMachineDisk
    metadata:
      name: DISK_NAME
    spec:
      size: 20Gi
      source:
        http:
          url: https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64.img
    

    Cet exemple crée un disque 20Gi (20 gibioctets) nommé DISK_NAME à l'aide d'une image Ubuntu publique.

  3. Enregistrez et fermez le fichier manifeste de disque dans votre éditeur.

  4. Créez le disque en utilisant kubectl :

    kubectl apply -f my-disk.yaml --kubeconfig KUBECONFIG
    

    Remplacez KUBECONFIG par le chemin d'accès au fichier kubeconfig du cluster.

Étapes suivantes