Convertir une VM en template : deux chemins, deux comportements
Fabriquer une image réutilisable à partir d'une machine qui tourne : où se trouve le bouton, ce que la conversion fait à la VM, et pourquoi recliquer sur la même VM échoue au lieu d'écraser.
Provisionner8 min de lectureUtilisateur propriétaire de la VM convertie
Ce que vous obtenez : Un template personnel créé depuis votre VM, et la connaissance exacte de ce qu'il transmet (et ne transmet pas).
Avant de commencer
- Une VM en marche : le bouton de conversion d'une ligne de
/app/vmsn'existe pas sur une VM arrêtée. - Un quota disque disponible : la copie compte dans votre quota disque avant tout travail. La barre d'état du tableau de bord affiche votre consommation de disque en permanence.
1.Trois entrées, deux comportements
Le produit ne propose aucun bouton « créer un template » : la seule façon de fabriquer une image est de convertir une machine existante. Trois boutons mènent à cette conversion, et ils ne se comportent pas de la même façon.
- Barre latérale « VMs »
- Ligne d'une VM en marche
- Bouton ⇄ « Convertir en template »
Aucune modale, aucune confirmation, aucun choix : un clic et la conversion part. Le template portera le nom de la VM.
2.Depuis la page VMs : ce qui se passe vraiment
Un clic sur ⇄ envoie une seule requête et affiche un message. Il n'y a ni confirmation, ni champ de nom, ni indication d'attente : le bouton ne se désactive pas pendant l'opération.
- 1
Le serveur vérifie que le template n'existe pas déjà
Contrôle sur le disque puis en base, avant tout autre travail (c'est ce qui explique qu'une reconversion ne touche pas la VM).
- 2
Il arrête la VM
La machine passe par un arrêt : c'est normal, et ce n'est annoncé nulle part. La durée de marche affichée par le tableau de bord repart de zéro après la conversion.
- 3
Il copie le rootfs et enregistre le template
Le nom du template est celui de la VM. La ligne apparaît dans « Mes templates » avec la mention « depuis <vm> · JJ/MM/AAAA ».
- 4
Il redémarre la VM en asynchrone
Le redémarrage n'est pas attendu par la requête : la machine revient quelques secondes plus tard.
Ce que vous observez, dans l'ordre :
| Ce qui se passe | Ce que vous voyez |
|---|---|
| La conversion part | Un seul envoi, aucun appel préparatoire |
| Elle aboutit en deux ou trois secondes | Aucun indicateur d'attente : le bouton reste actif |
| Elle réussit | Un message « Template créé » apparaît en bas à droite |
| La machine est redémarrée | Sa durée de marche affichée repart de zéro |
| La trace | Une ligne apparaît dans votre journal d'activité |
Le journal d'activité en garde la trace
La conversion écrit une ligne dans votre journal d'activité, visible sur la page correspondante. C'est le seul endroit où l'opération laisse un souvenir : aucune notification n'est renvoyée à la page.
3.Depuis le tableau de bord : la modale
La modale s'intitule « Convertir <nom de la machine> en template » et contient deux sections : le nom du template, puis ses ressources par défaut. Les valeurs sont reprises de la machine : pour une machine à 1 vCPU / 256 Mo / 2 Go, elles valent :
| Champ | Valeur proposée | Bornes du champ |
|---|---|---|
| Nom du template | le nom de la machine | champ texte libre |
| vCPU | 1 | 1 à 4 (ancres 1, 2, 4) |
| RAM | 256 Mo | 128 à 8192 Mo (ancres 128 Mo → 8 Go) |
| Disque | 2048 Mo | 1024 à 102400 Mo (ancres 1, 5, 10, 50, 100 Go) |
Ces ressources ne sont pas des valeurs de clonage
Elles sont documentaires. Elles sont bien enregistrées avec le template, mais l'écran de création d'une machine ne les relit jamais : ni les curseurs, ni la fiche ne s'en servent. Le disque réellement copié est celui du système de fichiers de la machine, pas la valeur affichée ici.
Ce qui compte dans votre quota
La conversion consomme de votre quota disque, mais pas à hauteur du disque déclaré de la machine : ce sont les blocs réellement écrits qui sont comptés. Sur une machine à 2 Go déclarés, l'écart se compte en centaines de Mo.
4.Reconvertir la même VM : le refus, et ce qu'il prouve
Sur la page VMs, le nom du template est toujours celui de la machine. On pourrait donc croire qu'un second clic sur ⇄ écrase le template existant. C'est faux : la conversion est refusée avant tout travail.
- 1
Le clic part comme d'habitude
Même bouton, même absence de confirmation, même attente silencieuse.
- 2
La conversion est refusée
Un message d'erreur apparaît, portant le code
ALREADY_EXISTS. Rien n'est écrit, ni sur le disque, ni en base. - 3
L'interface affiche le message traduit, qui porte le code
Le message affiché est « Une erreur est survenue (code ALREADY_EXISTS) ». Le texte anglais du serveur n'est plus montré tel quel : l'interface affiche une phrase française qui porte le code d'erreur, pour qu'un signalement reste rattachable. Conséquence pratique : le nom du template en conflit n'apparaît plus à l'écran, il faut le déduire du nom de la machine qu'on vient de convertir.
- 4
Rien n'a changé, ni le template ni la machine
Le template existant garde sa date de création. Et surtout, la durée de marche affichée par le tableau de bord continue d'augmenter normalement : la machine n'a pas été arrêtée, alors qu'une conversion réussie remet ce compteur à zéro.
Ne comptez pas sur une reconversion comme mise à jour
Il n'existe aucun moyen de rafraîchir un template existant depuis une machine : la seconde conversion est refusée. Pour mettre l'image à jour, il faut supprimer le template (bouton corbeille de la page Templates, avec une confirmation du navigateur) puis convertir de nouveau. Cette suppression, elle, n'est pas annulable.
Conséquence pratique : comme le nom du template est imposé par celui de la machine, un compte ne peut avoir qu'une seule image par nom de machine. Renommer la machine avant de la convertir est la seule façon d'obtenir une image à un autre nom depuis la page VMs ; la modale du tableau de bord, elle, accepte un nom libre.
5.Ce que le template transmet à une future VM
Un template n'est pas une sauvegarde et ne contient pas tout. Un template converti reçoit automatiquement la description Converted from VM <nom>, écrite par la plateforme et non par vous.
| Élément | Transmis à une nouvelle VM ? |
|---|---|
| Le système de fichiers de la machine | Oui, copié au premier démarrage |
| Le noyau par défaut, s'il est déclaré | Oui, sinon la machine suit la résolution automatique |
| Les ports publiés automatiquement | Oui, si la case est cochée à la création |
| La description | Non, c'est un affichage |
| Les ressources « par défaut » de la modale | Non, jamais relues à la création |
Il n'existe aucun instantané de VM
La conversion est la seule opération qui fige l'état d'une machine. Prendre une image avant une manipulation risquée est possible, mais ce n'est ni un retour arrière ni une sauvegarde : la conversion exige une machine en marche depuis la page VMs, arrête la machine, et compte dans votre quota disque.
Les pièges, en résumé
Reconvertir une machine n'écrase pas, la conversion est refusée
Le refus affiché est « Une erreur est survenue (code ALREADY_EXISTS) » : le code est là, mais le nom du template en conflit ne l'est plus. Rien n'est réécrit, et la machine n'est même pas arrêtée : c'est le meilleur moyen de distinguer « rien ne s'est passé » de « tout est passé ».
La machine est arrêtée puis redémarrée, sans avertissement
Aucune confirmation, aucun message d'attente, bouton toujours actif. Comptez quelques secondes d'interruption : la durée de marche affichée repart de zéro après une conversion réussie.
Depuis la page VMs, le nom du template vous échappe
Il est pris d'office sur la machine. Un template par nom de machine au maximum : une seconde conversion échoue au lieu d'écraser.
Les ressources de la modale ne dimensionnent rien
Ce sont des valeurs par défaut de documentation. La création d'une machine ne les lit pas : vous repartirez des curseurs standard.
Le disque pré-rempli n'est pas une ancre
Une machine de 2 Go pré-remplit 2048 Mo, alors que les ancres du curseur sont 1, 5, 10, 50 et 100 Go : aucune pastille n'est mise en évidence, et celle qui s'en approche le plus peut faire croire à une sélection.
Un template n'est pas une sauvegarde
La conversion copie le système de fichiers d'une machine vivante ; elle ne permet ni le retour à un état antérieur, ni de repartir d'un instantané. Supprimer un template ne touche pas aux machines qui en sont issues, mais l'une d'elles ne peut plus être remise à son image d'origine.
Ce guide est-il a jour ?
Chaque affirmation de cette page a ete verifiee sur le produit avant publication, et ce qui n'etait pas verifie n'a pas ete ecrit. Une page peut cependant vieillir avant le produit : si un ecran ne correspond plus a ce que vous voyez, dites-le, la page sera reprise.
Prêt à créer vos premières VMs ?
30 secondes d'inscription. 2 secondes pour la première VM. Zéro engagement.