Orbit

Snapshots et Restore dans Kapsule Orbit

Every Orbit project takes a nightly snapshot of two things that are otherwise impossible to get back once you delete them: your config store entries and your environment variables. Thirty nights are…

Snapshots and Restore in Orbit

Chaque projet Orbit prend un snapshot chaque nuit de deux éléments qu'il est autrement impossible de récupérer une fois supprimés : vos entrées de config store et vos variables d'environnement. Trente nuits sont conservées, sur tous les plans y compris le plan gratuit, et vous pouvez restaurer n'importe laquelle d'entre elles vous-même en une seule action confirmée.

Ce guide couvre exactement ce qu'un snapshot contient, ce qu'il ne contient pas, comment en restaurer un, et comment annuler une restauration.

Ce qu'un Snapshot Contient

Chaque snapshot nocturne contient, pour le projet auquel il appartient :

  • Chaque entrée du config store : la clé, la valeur, et si l'entrée est injectée dans la page.
  • Chaque variable d'environnement, à la fois les variables au niveau du projet et les remplacements par environnement, incluant leurs valeurs, leurs types d'environnement cible et leur délimitation de branche.

Les valeurs sont chiffrées au repos avec la même clé et le même chiffrement que vos variables d'environnement elles-mêmes, donc un snapshot ne rend jamais un secret plus accessible que la variable dont il provient.

Ce qu'un Snapshot Ne Contient Pas

C'est la partie qui vaut la peine d'être lue avant de vous y fier.

  • Votre dépôt git. Il est hébergé chez votre fournisseur git et il vous appartient. Orbit ne le copie pas.
  • Objets du blob store. Votre stockage de blob est déjà durable et ne fait pas partie d'un snapshot.
  • Artefacts de build. Les builds réussis sont conservés selon la fenêtre de rétention des déploiements de votre plan, qui est un paramètre séparé du projet. La restauration d'un snapshot ne restaure pas un build, et l'annulation d'un déploiement ne restaure pas la configuration ou les variables d'environnement. Voir Rolling Back a Deployment.
  • Bases de données, journaux, analyses ou tout ce que votre application écrit à l'exécution.

Durée de Conservation des Snapshots

Trente nuits, sur tous les plans. Après cela, un snapshot est supprimé automatiquement.

Il y a une exception délibérée. Les trois snapshots les plus récents sont toujours conservés, même après avoir dépassé trente nuits. Un projet que vous n'avez pas touché depuis deux mois verrait sinon chaque snapshot expirer la même nuit et vous laisser sans rien à restaurer au moment exact où vous en avez finalement besoin.

Restaurer un Snapshot

  1. Ouvrez votre projet dans Orbit.
  2. Ouvrez Settings, puis Snapshots.
  3. Trouvez la nuit que vous voulez. Chaque ligne affiche le nombre d'entrées de configuration et de variables d'environnement qu'elle contient, et quand elle sera supprimée.
  4. Cliquez sur Restore this snapshot.
  5. Tapez la phrase de confirmation exactement comme indiqué. Elle nomme votre projet et la nuit que vous restaurez, par exemple restore my-blog 2026-08-30.
  6. Cliquez sur Restore now.

La restauration nécessite le rôle Owner ou Admin sur le compte qui possède le projet. Quiconque peut voir le projet peut lire son historique de snapshots.

Ce qu'une Restauration Fait Réellement

Une restauration ramène votre projet à l'état de cette nuit. Cela signifie que ce n'est pas une fusion :

  • les entrées et variables qui existaient alors et qui manquent maintenant sont recréées, avec leurs valeurs originales ;
  • les entrées et variables dont les valeurs ont changé depuis sont restaurées ;
  • les entrées et variables que vous avez ajoutées après cette nuit sont supprimées.

L'écran vous dit exactement ce qui s'est passé ensuite : combien ont été ajoutés, combien ont changé, et combien ont été supprimés, pour le config store et les variables d'environnement séparément.

Annuler une Restauration

Avant qu'une restauration n'écrive quoi que ce soit, Orbit prend un snapshot de l'état qu'il est sur le point de remplacer. Il apparaît dans votre liste sous la forme d'une ligne Before a restore, et l'écran de confirmation la nomme quand la restauration se termine.

Donc si vous restaurez la mauvaise nuit, restaurez cette ligne et vous êtes revenu où vous aviez commencé. Rien à propos d'une restauration n'est à sens unique.

Après la Restauration des Variables d'Environnement

Un déploiement en cours détient les variables d'environnement avec lesquelles il a été construit et lancé. Les restaurer change ce que votre prochain déploiement utilisera, donc redéployez si vous avez besoin que les valeurs restaurées soient en direct. Le projet affiche une bannière quand votre configuration a changé depuis le dernier déploiement.

Chaque variable qu'une restauration crée, modifie ou supprime est enregistrée sur l'historique des variables d'environnement du projet, avec qui l'a fait et quand, exactement comme un changement manuel.

Questions Fréquemment Posées

Quand le snapshot s'exécute-t-il ? Chaque nuit, à 04:00 UTC, dans le cadre du même passage nocturne qui supprime les anciens artefacts de build.

Puis-je en prendre un à la demande ? Pas depuis l'écran aujourd'hui. Une restauration en prend toujours un d'abord, donc l'état avant toute restauration est toujours capturé.

Un snapshot coûte-t-il quelque chose ? Non. Les snapshots sont inclus sur tous les plans, et le config store lui-même est gratuit à lire et à écrire.

La restauration révélera-t-elle un secret que j'ai marqué en écriture seule ? Non. Une restauration remet la valeur en place ; elle ne l'affiche pas. Une variable en écriture seule reste en écriture seule.

Vous avez besoin d'aide?

Envoyez-nous un email à support@kapsulehost.com ou ouvrez un chat dans KPanel.

Ouvrir KPanel
Snapshots et Restore dans Kapsule Orbit