Activer ou désactiver l'environnement d'exécution des VM Anthos

Ce document explique comment activer ou désactiver l'environnement d'exécution des VM Anthos en mettant à jour la ressource personnalisée VMRuntime ou en exécutant les commandes bmctl.

Avant de commencer

Pour activer ou désactiver l'environnement d'exécution des VM Anthos, vous devez avoir accès aux ressources et outils suivants :

Activer l'environnement d'exécution des VM Anthos

L'environnement d'exécution des VM Anthos est automatiquement installé sur les clusters Anthos sur solution Bare Metal version 1.10 ou ultérieure, mais il est désactivé par défaut. Avant de pouvoir exécuter des ressources de VM dans vos clusters Anthos sur solution Bare Metal, vous devez activer l'environnement d'exécution de VM Anthos.

bmctl

  • Pour activer l'environnement d'exécution, utilisez l'outil bmctl :

    bmctl enable vmruntime --kubeconfig KUBECONFIG_PATH
    

    Indiquez le chemin d'accès au fichier kubeconfig du cluster. Les clusters Anthos sur Bare Metal génèrent le fichier kubeconfig sur le poste de travail administrateur lorsque vous créez un cluster. Par défaut, le chemin d'accès est bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-kubeconfig.

    Si l'environnement d'exécution des VM Anthos est déjà activé, la commande renvoie une erreur.

Vous pouvez configurer des paramètres supplémentaires, tels que l'émulation ou le format d'image, en modifiant la ressource personnalisée VMRuntime.

Ressource personnalisée

Pour activer l'environnement d'exécution, mettez à jour la ressource personnalisée VMRuntime. Cette ressource personnalisée est installée par défaut.

  1. Modifiez la ressource personnalisée VMRuntime :

    kubectl edit vmruntime
    
  2. Définissez enabled:true dans la spécification :

    apiVersion: vm.cluster.gke.io/v1
    kind: VMRuntime
    metadata:
      name: vmruntime
    spec:
      enabled: true
      # useEmulation defaults to "false" if not set.
      useEmulation: true
      # vmImageFormat defaults to "qcow2" if not set.
      vmImageFormat: qcow2
    

    Dans la section spec précédente, les valeurs suivantes peuvent être définies :

    • enabled : défini sur "true" pour activer l'environnement d'exécution des VM Anthos
    • useEmulation : si votre nœud n'est pas compatible avec la virtualisation matérielle, ou si vous n'êtes pas sûr, définissez la valeur sur "true". Si elle est disponible, la virtualisation matérielle offre de meilleures performances que l'émulation logicielle. Le champ useEmulation est défini par défaut sur false s'il n'est pas spécifié.
    • vmImageFormat : accepte deux valeurs de format d'image disque : raw et qcow2. Si vous ne définissez pas vmImageFormat, l'environnement d'exécution des VM Anthos utilise le format d'image disque raw pour créer des VM. Le format raw peut améliorer les performances par rapport à qcow2, un format qui utilise la copie sur écriture, mais peut utiliser plus d'espace disque. Pour en savoir plus sur les formats d'image de votre VM, consultez la section Formats de fichiers d'image disque dans la documentation de QEMU.
  3. Enregistrez la ressource personnalisée dans votre éditeur.

  4. Vérifiez que la ressource personnalisée VMRuntime est activée :

    kubectl describe vmruntime vmruntime
    

    Les détails de la ressource personnalisée VMRuntime incluent une section Status. L'environnement d'exécution des VM Anthos est activé et fonctionne lorsque VMRuntime.Status.Ready affiche l'état true.

Désactiver l'environnement d'exécution des VM Anthos

Lorsque vous n'avez plus besoin d'utiliser l'environnement d'exécution des VM Anthos, vous pouvez désactiver cette fonctionnalité.

bmctl

  • Pour désactiver l'environnement d'exécution, utilisez l'outil bmctl :

    bmctl disable vmruntime --kubeconfig KUBECONFIG_PATH \
      --force=true
    

    Indiquez le chemin d'accès au fichier kubeconfig de votre cluster et les valeurs à utiliser pour les options de configuration suivantes :

    • --force : définissez la valeur sur true pour confirmer que vous souhaitez supprimer les ressources de VM existantes. La valeur par défaut est false.

Ressource personnalisée

Pour désactiver l'environnement d'exécution, mettez à jour la ressource personnalisée VMRuntime :

  1. Modifiez la ressource personnalisée VMRuntime :

    kubectl edit vmruntime
    
  2. Définissez enabled:false dans la spécification :

    apiVersion: vm.cluster.gke.io/v1`
    kind: VMRuntime
    metadata:
      name: vmruntime
    spec:
      enabled: false
      useEmulation: true
      vmImageFormat: qcow2
    
  3. Enregistrez la spécification de ressource personnalisée mise à jour dans l'éditeur.

  4. Pour vérifier que la ressource personnalisée VMRuntime est désactivée, affichez les pods qui s'exécutent dans l'espace de noms vm-system :

    kubectl get pods --namespace vm-system
    

    L'environnement d'exécution des VM Anthos est désactivé lorsque seuls les pods appartenant au déploiement vmruntime-controller-manager sont en cours d'exécution dans l'espace de noms.

Comprendre le comportement d'exécution des VM

L'annotation baremetal.cluster.gke.io/vmrumtime-force-disable peut être utilisée sur la ressource d'environnement d'exécution des VM Anthos pour définir le comportement lorsque l'environnement d'exécution est désactivé pendant l'exécution des VM dans le cluster.

L'exemple suivant montre que la valeur de cette annotation est définie sur false par défaut :

  // VM runtime yaml file
  apiVersion: vm.cluster.gke.io/v1
  kind: VMRuntime
  metadata:
    annotations:
      baremetal.cluster.gke.io/vmrumtime-force-disable: "false"
    name: vmruntime
  [...]

Lorsque cette annotation est définie sur false, l'environnement d'exécution des VM Anthos tente de protéger les VM en cours d'exécution. Supprimez toutes les VM en cours d'exécution avant que l'environnement d'exécution des VM Anthos ne soit désactivé, ou spécifiez le paramètre --force=true avec la commande bmctl disable vmruntime comme indiqué dans la section précédente.

Le tableau suivant explique ce qu'il advient des VM lorsque cette annotation est définie sur true ou false, et lorsque vous spécifiez ou non le paramètre --force=true :

État du cluster Paramètre --force Annotation vmrumtime-force-disable Comportement
Aucune VM Non disponible Non disponible Désactive l'environnement d'exécution des VM Anthos.
VM existantes Vrai Vrai Supprime toutes les VM en cours d'exécution et les ressources associées. Désactive l'environnement d'exécution des VM Anthos.
Vrai Faux Supprime toutes les VM en cours d'exécution et les ressources associées. Désactive l'environnement d'exécution des VM Anthos.
Faux Vrai Invite à supprimer les VM en cours d'exécution et les ressources associées. Une fois toutes les VM en cours d'exécution supprimées, désactive l'environnement d'exécution des VM Anthos.
Faux Faux Ne supprime aucune VM en cours d'exécution. Ne désactive pas l'environnement d'exécution des VM Anthos. La commande bmctl renvoie une erreur.

Étapes suivantes