Aller au contenu principal

Comment restaurer une VM ou un disque

Ce guide restaure une machine virtuelle, ou un disque supprimé, à partir d'une archive, depuis la console Hikube.

Prérequis​

  • Une archive Prête et restaurable de la VM ou du disque (voir Gérer les archives).
  • Pour l'onglet API : une clé d'API du projet (admin pour créer, modifier, lancer, restaurer ou supprimer ; read pour consulter) et les variables HIKUBE_API, HIKUBE_API_KEY et PROJECT_ID (voir Préparer l'environnement) ; les exemples utilisent curl et jq.

Ce qu'il faut savoir​

  • Une VM ou un disque se restaure sur lui-même, jamais sur une autre ressource.
  • L'archive d'une VM contient tous ses disques, et la restauration les réécrit tous. Il n'est pas possible de n'en restaurer qu'un.
  • Un disque sauvegardé seul ne se restaure pas sur lui-même tant qu'il existe. Pour revenir à un état antérieur d'un disque attaché, restaurez une archive de la VM qui le porte. L'archive d'un disque sert à le recréer s'il a été supprimé.
  • La VM est arrêtée pendant la restauration : prévoyez une interruption de service.

Restaurer une VM​

  1. Ouvrez Instances VM, la VM, puis son onglet Sauvegardes. Vous pouvez aussi partir de Sauvegardes > Archives.

  2. Sur la ligne de l'archive, cliquez sur Restaurer.

  3. Choisissez le sort de Les disques actuels de cette machine :

    ChoixEffet
    Les supprimer (par défaut)Chaque disque reprend le contenu de l'archive ; ce qu'il contenait jusqu'ici est supprimé une fois la restauration réussie.
    Les garderChaque disque reprend le contenu de l'archive ; ce qu'il contenait jusqu'ici devient un disque à part, nommé <disque>-orig-<identifiant>, détaché, facturé jusqu'à ce que vous le supprimiez.

  4. Saisissez le nom de la VM pour confirmer, puis cliquez sur Restaurer.

Quand garder les anciens disques

Choisissez Les garder si vous n'êtes pas certain que l'archive est la bonne : vous pourrez attacher un ancien disque à une VM pour en récupérer des fichiers. Pensez à le supprimer ensuite depuis Disques.

Recréer une VM ou un disque supprimé​

Si la VM ou le disque a été supprimé, la console l'indique (« … » a été supprimée : elle sera recréée à partir de cette archive). La restauration recrée la ressource sous son nom d'origine.

Pour une VM supprimée dont des disques ont survécu, le choix porte sur Les disques qui ont survécu à cette machine.

Si une nouvelle VM ou un nouveau disque porte désormais le même nom, créé après la sauvegarde, la restauration est refusée : elle remplacerait les données d'une autre ressource. Supprimez d'abord cette ressource, puis restaurez. Il en va de même si l'un des disques contenus dans l'archive d'une VM a été supprimé puis recréé depuis la sauvegarde. Avec l'API, ce refus porte le code 180222.

Suivre la restauration​

  • La section Restaurations de l'onglet Sauvegardes affiche le statut, le pourcentage de données transférées et le sort des disques d'origine (Disques d'origine supprimés si la restauration réussit, Disques d'origine gardés…).
  • Avant de passer à Réussie, la restauration vérifie que chaque disque de l'archive a bien été réécrit ; elle reste En cours pendant ces quelques secondes.
  • Une restauration qui échoue, ou que vous annulez, ne supprime rien, même avec Les supprimer : les anciens disques sont gardés sous le nom <disque>-orig-<identifiant>, et le message le dit (Disques d'origine gardés : la restauration n'a pas réussi). Relancer la restauration peut réussir.
  • Une restauration de VM ne s'arrête pas d'elle-même si elle reste bloquée : vous pouvez l'annuler (voir Annuler une sauvegarde ou une restauration).

Vérification​

  • La restauration est Réussie.
  • Démarrez la VM si elle est arrêtée, connectez-vous et contrôlez vos données.
  • Avec Les garder, les disques <disque>-orig-<identifiant> apparaissent dans Disques, non attachés.

Pour aller plus loin​