Instantanés

Prendre, restaurer, renommer et supprimer des instantanés d'une machine virtuelle dans la console, avec ou sans sa mémoire.

Un instantané est une copie à un instant donné des disques d'une machine virtuelle, et éventuellement de sa mémoire. Kyvernon conserve les instantanés d'une machine sous forme d'arborescence et mémorise la configuration au moment de chacun. La restauration rétablit cette configuration et l'état des disques.

Un instantané n'est pas une sauvegarde : il vit avec les disques sur le même datastore. Les disques définis comme indépendants sont exclus des instantanés, voir Modifier le matériel. Un modèle ne peut pas faire l'objet d'un instantané.

Dans la console

Dans l'inventaire, sélectionnez la machine virtuelle puis Instantanés sous Autres actions. La boîte de dialogue liste les instantanés sous forme d'arborescence, l'instantané actuel étant marqué (actuel), et propose le formulaire pour en prendre un nouveau.

(Agrandir)
Fermer la vue agrandie
Pour prendre un instantané, saisissez un Nom de 1 à 80 caractères et, en option, des Description. Sélectionnez Inclure la mémoire (invités sous tension uniquement) pour capturer aussi la mémoire. Cela fonctionne pour une machine sous tension, et une restauration reprend alors l'invité en cours d'exécution. Sélectionnez Mettre au repos les systèmes de fichiers de l’invité pour que l'agent invité vide et fige les systèmes de fichiers avant l'instantané, afin que les disques soient cohérents ; il faut un invité en marche avec un agent invité en marche, sinon l'option est désactivée. Sélectionnez Prendre un instantané.
Pour revenir en arrière, sélectionnez Restaurer sur un instantané et confirmez. Les modifications effectuées depuis sont perdues.
Pour changer le nom ou la description, sélectionnez Modifier sur un instantané, modifiez-les puis sélectionnez Enregistrer l’instantané. Votre rôle doit avoir le privilège de renommer les instantanés.
Pour en supprimer un, sélectionnez Supprimer et confirmez. L'instantané est fusionné dans les disques et ne peut plus être restauré. Supprimer tous les instantanés le fait pour tous les instantanés de la machine.

Résultat

L'instantané apparaît dans la liste, marqué mémoire lorsqu'il contient la mémoire de l'invité et mis au repos lorsque les systèmes de fichiers ont été mis au repos. Après une restauration, la configuration et les disques sont tels qu'ils étaient au moment de la prise de l'instantané. Chaque opération est une tâche du volet des tâches.

Automatisation

Avec la CLI

Shell

kyvernon vm snapshot create <id> --name before-upgrade --description "Kernel 6.12" --memory --wait
kyvernon vm snapshot revert <id> <key> --wait
kyvernon vm snapshot rename <id> <key> --name after-upgrade
kyvernon vm snapshot remove <id> <key> --children --wait
kyvernon vm snapshot remove-all <id> --wait

<key> est le numéro de l'instantané au sein de sa machine ; kyvernon inventory vm <id> liste les instantanés. Les options sont les suivantes :

--memory capture la mémoire d'une machine sous tension.
--quiesce demande à l'agent invité de mettre d'abord les systèmes de fichiers au repos, lorsqu'un agent s'exécute.
revert --suppress-power-on ne met pas l'invité sous tension après la restauration d'un instantané qui contient la mémoire.
remove --children supprime aussi les instantanés situés en dessous.

Avec l'API

Opération	Requête
Prendre	`POST /v1/vms/{id}/snapshots` avec `name`, `description`, `memory`, `quiesce`
Restaurer	`POST /v1/vms/{id}/snapshots/{key}/revert`, `suppressPowerOn` facultatif
Renommer	`POST /v1/vms/{id}/snapshots/{key}/rename` avec `name` ou `description`
Supprimer un instantané	`DELETE /v1/vms/{id}/snapshots/{key}`, paramètre `removeChildren=true` pour le sous-arbre
Tout supprimer	`DELETE /v1/vms/{id}/snapshots`

Prendre, restaurer et supprimer répondent par une tâche. Renommer répond immédiatement.

Clones et modèles : un clone lié part d'un instantané.
Dépannage