Les clusters Anthos sur Bare Metal sont désormais Google Distributed Cloud (logiciel uniquement) pour Bare Metal. Pour en savoir plus, consultez la présentation du produit.

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

Ce document explique comment activer ou désactiver l'environnement d'exécution des VM sur Google Distributed Cloud 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 sur GDC, vous devez avoir accès aux ressources et outils suivants :

Accès au cluster Google Distributed Cloud version 1.12.0 (anthosBareMetalVersion: 1.12.0) ou ultérieure. Vous pouvez utiliser n'importe quel type de cluster capable d'exécuter des charges de travail. Si nécessaire, essayez Google Distributed Cloud sur Compute Engine ou consultez la présentation de la création de clusters.
Outil de ligne de commande bmctl Pour en savoir plus, consultez la page Télécharger et installer l'outil bmctl.

Activer l'environnement d'exécution des VM sur GDC

L'environnement d'exécution des VM sur GDC est automatiquement installé sur la version 1.10 ou ultérieure de Google Distributed Cloud, mais il est désactivé par défaut. Avant de pouvoir exécuter des ressources de VM dans Google Distributed Cloud, vous devez activer l'environnement d'exécution de VM sur GDC.

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. Google Distributed Cloud génère 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 de VM sur GDC 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.

Modifiez la ressource personnalisée VMRuntime :
```
kubectl edit vmruntime
```
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 sur GDC
- 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 sur GDC 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.
Enregistrez la ressource personnalisée dans votre éditeur.
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 de VM sur GDC est activé et fonctionne lorsque VMRuntime.Status.Ready affiche l'état true.

Désactiver l'environnement d'exécution des VM sur GDC

Lorsque vous n'avez plus besoin d'utiliser l'environnement d'exécution des VM sur GDC, 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 :

Modifiez la ressource personnalisée VMRuntime :
```
kubectl edit vmruntime
```

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

Enregistrez la spécification de ressource personnalisée mise à jour dans l'éditeur.
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 de VM sur GDC 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 l'environnement d'exécution des VM sur une ressource GDC 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 sur GDC tente de protéger les VM en cours d'exécution. Supprimez toutes les VM en cours d'exécution avant la désactivation de l'environnement d'exécution des VM sur GDC, 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	N/A	N/A	Désactive l'environnement d'exécution des VM sur GDC.
VM existantes	Vrai	True	Supprime toutes les VM en cours d'exécution et les ressources associées. Désactive l'environnement d'exécution de VM sur GDC.
	True	Faux	Supprime toutes les VM en cours d'exécution et les ressources associées. Désactive l'environnement d'exécution de VM sur GDC.
	Faux	True	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 sur GDC.
	Faux	Faux	Ne supprime aucune VM en cours d'exécution. Ne désactive pas l'environnement d'exécution des VM sur GDC. La commande `bmctl` renvoie une erreur.

Vérification préliminaire de l'environnement d'exécution de VM sur GDC

La vérification préliminaire de l'environnement d'exécution des VM sur GDC valide un ensemble de conditions préalables à l'utilisation de l'environnement de la machine avant d'utiliser l'environnement d'exécution des VM sur GDC et les VM. La création de VM est bloquée si la vérification préliminaire de l'environnement d'exécution de VM sur GDC a échoué. La vérification préliminaire de l'environnement d'exécution de VM sur GDC s'exécute automatiquement lorsque spec.enabled est défini sur "true".

kubectl label nodes NODE_NAME "kubevm.io/VM-SkipSchedule"= --kubeconfig KUBECONFIG_PATH

La vérification préliminaire de l'environnement d'exécution des VM sur GDC s'exécute lorsque vous effectuez l'une des opérations suivantes :

Activer l'environnement d'exécution des VM sur GDC
Activer des fonctionnalités de l'environnement d'exécution des VM sur GDC, telles que useEmulation
Mettre à niveau les clusters
Supprimer le libellé kubevm.io/VM-SkipSchedule au niveau des nœuds
Créez indépendamment l'objet vérification préliminaire de l'environnement d'exécution des VM sur GDC en exécutant la commande bmctl check vmruntimepfc --kubeconfig KUBECONFIG_PATH ou en appliquant un fichier manifeste YAML VMRuntimePreflightCheck.

Vous pouvez lancer des VM lorsque la dernière vérification préliminaire des VM sur GDC a réussi. En cas d'échec de la vérification préliminaire, la création de la VM est bloquée, et vous obtenez des erreurs lors de ces vérifications.

Vérifier la réussite de la vérification préliminaire

Pour vérifier si les vérifications préliminaires ont réussi, exécutez les commandes suivantes :

Recherchez les dernières vérifications préliminaires effectuées :

kubectl get vmruntimepfc -n vm-system --kubeconfig KUBECONFIG_PATH

Le résultat doit ressembler à l'exemple ci-dessous :

NAME                                                             PASS    AGE
vmruntime-preflight-check-6ee61513-ea5d-4340-9374-90396cac129e   false   42s
vmruntime-preflight-check-f8d71751-a01c-471e-bab5-3370fc2addd5   true    21s

Pour connaître l'état d'une vérification préliminaire, exécutez la commande suivante :

kubectl get vmruntime vmruntime -o yaml --kubeconfig KUBECONFIG_PATH

...
  preflightCheckSummary:
  preflightCheckSummary:
    featureStatuses:
      CPU:
        passed: true
      KVM:
        passed: true
    preflightCheckName: vmruntime-preflight-check-f8d71751-a01c-471e-bab5-3370fc2addd5
    preflightCheckPassed: true
...

Déboguer la vérification préliminaire

Si la vérification préliminaire échoue, procédez comme suit pour la déboguer :

Rechercher les dernières vérifications préliminaires effectuées
```
kubectl get vmruntimepfc -n vm-system
```

Pour en savoir plus, vérifiez l'état de cette vérification préliminaire.

kubectl get vmruntimepfc -n vm-system \
    vmruntime-preflight-check-6ee61513-ea5d-4340-9374-90396cac129e -o yaml \
    --kubeconfig KUBECONFIG_PATH

...
status:
checks:
  worker-0--52229ee15841099-22c41577139a7b8c.lab.anthos:
    passed: false
    results:
    - checkName: CPU
      passed: true
    - checkName: KVM
      message: |
        command terminated with exit code 1
        ls: /mnt/dev/kvm: No such file or directory
      passed: false
...

Corrigez le problème et exécutez à nouveau la vérification préliminaire de l'environnement d'exécution de VM sur GDC. Voici un exemple de fichier manifeste YAML VMRuntimePreflightCheck :
```
apiVersion: vm.cluster.gke.io/v1
kind: VMRuntimePreflightCheck
metadata:
  name: vmruntime-preflight-check-manual
  namespace: vm-system
```

Étape suivante

Créez une VM dans Google Distributed Cloud.