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 :

Accès aux clusters Anthos sur solution Bare Metal version 1.12.0 (anthosBareMetalVersion: 1.12.0) ou cluster supérieur. Vous pouvez utiliser n'importe quel type de cluster capable d'exécuter des charges de travail. Si nécessaire, essayez des clusters Anthos sur solution Bare Metal 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 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.

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

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

Créez une VM dans des clusters Anthos sur solution Bare Metal.