EO VM Manager doit gérer des machines sur Proxmox VE et sur VMware vSphere. Pour l’utilisateur, il n’y a qu’une liste de VM, un bouton « Démarrer » et un bouton « Migrer ». Derrière, les deux plateformes ne se ressemblent pas du tout. Cet article raconte ce qui nous a demandé le plus de travail.
Une interface commune, deux implémentations
Le code métier ne connaît que des fournisseurs abstraits : créer une VM, la démarrer, l’arrêter, la cloner, la migrer, lire son état. Une fabrique renvoie l’implémentation Proxmox ou vSphere selon le cluster. Ajouter un fournisseur revient à écrire une nouvelle classe, sans toucher aux écrans ni aux règles d’accès.
Côté Proxmox, nous utilisons un jeton d’API (utilisateur@realm!jeton) plutôt qu’un mot de passe. Côté vSphere, nous passons par vCenter, avec l’API REST quand elle couvre le besoin et pyVmomi pour le reste.
La différence importante, c’est que presque tout est asynchrone. Une migration ou un clonage Proxmox renvoie tout de suite un identifiant de tâche (UPID), et le travail se fait ensuite. vSphere fonctionne de la même façon avec ses Task. L’API FastAPI crée donc une tâche, la confie à un worker Celery, et le worker suit l’avancement. L’interface reçoit l’état par WebSocket, sans recharger la page.
L’agent invité change tout
Au début, nos VM s’affichaient sans adresse IP. Proxmox ne peut pas deviner l’IP d’une machine : il faut que le système invité la donne. C’est le rôle de qemu-guest-agent.
Nous l’avons rendu obligatoire dans tous les modèles : le paquet est installé dans l’image et l’option agent est activée sur la VM. Avec l’agent, l’API répond sur /nodes/{node}/qemu/{vmid}/agent/network-get-interfaces, l’arrêt d’une VM est propre au lieu d’être une coupure, et le système de fichiers peut être figé pendant une sauvegarde.
Sur vSphere, l’équivalent est VMware Tools. Nos modèles Windows et Linux l’embarquent, et vCenter remonte alors l’IP et le nom d’hôte. Une VM créée sans agent est signalée dans l’interface, parce qu’elle posera problème plus tard.
Lire un cluster correctement
L’écran Infrastructure affiche, par cluster, les nœuds en ligne, le quorum, la haute disponibilité et la capacité. Sur Proxmox, tout vient de /cluster/status et /cluster/resources, que nous agrégeons : cœurs, mémoire libre, stockage utilisé. Sur vSphere, les mêmes chiffres viennent des hôtes et des datastores.
Deux réglages de cluster nous ont évité des soucis :
- Un stockage partagé (une LUN iSCSI) pour les disques des VM. Les disques ne bougent pas lors d’une migration, seule la mémoire est copiée.
- Un même modèle de CPU pour toutes les VM (
x86-64-v2-AES) au lieu dehost. Une VM peut alors passer d’un nœud à l’autre même si les processeurs physiques ne sont pas identiques.
Migration à chaud et vidage de nœud
Sur Proxmox, une migration à chaud est un appel à POST /nodes/{node}/qemu/{vmid}/migrate avec target et online=1. Avec un stockage partagé, elle dure le temps de copier la mémoire. Avec des disques locaux, il faut with-local-disks, et c’est beaucoup plus long. Sur vSphere, c’est vMotion, via une relocalisation de la VM vers un autre hôte.
Avant de lancer quoi que ce soit, nous vérifions trois choses : le nœud cible est en ligne, il a assez de mémoire libre, et la VM n’a pas de périphérique local qui bloquerait le déplacement. Une migration refusée au départ vaut mieux qu’une migration qui échoue à 80 %.
Le vidage d’un nœud avant maintenance s’appuie sur la même brique : nous listons ses VM, nous les migrons une par une en attendant la fin de chaque tâche, puis nous marquons le nœud comme indisponible. Une par une, parce que lancer dix migrations en même temps sature le réseau et fait échouer les dernières.
Ce que je retiens
- L’agent invité n’est pas une option. Il faut le mettre dans les modèles dès le premier jour.
- Toute action longue passe par une file de tâches, et l’utilisateur voit l’avancement.
- Un stockage partagé et un modèle de CPU commun rendent la migration à chaud banale. Sans eux, elle devient un projet en soi.
- La couche fournisseurs paie dès le deuxième hyperviseur.