Snapshots and Restore in Orbit

Jedes Orbit-Projekt erstellt jede Nacht einen Snapshot von zwei Dingen, die sonst unmöglich zurückzubekommen sind, wenn Sie sie löschen: Ihre Config-Store-Einträge und Ihre Umgebungsvariablen. Dreißig Nächte werden aufbewahrt, bei jedem Plan einschließlich des kostenlosen Plans, und Sie können jeden von ihnen selbst in einer bestätigten Aktion wiederherstellen.

Dieser Leitfaden behandelt genau, was ein Snapshot enthält, was er nicht enthält, wie man einen Snapshot wiederherstellt und wie man eine Wiederherstellung rückgängig macht.

Was ein Snapshot enthält

Jeder nächtliche Snapshot enthält für das Projekt, zu dem er gehört:

• Jeden Config-Store-Eintrag: den Schlüssel, den Wert und ob der Eintrag in die Seite injiziert wird.
• Jede Umgebungsvariable, sowohl die auf Projektebene als auch die Pro-Umgebungs-Überrides, einschließlich ihrer Werte, ihrer Zielumgebungstypen und ihres Branch-Scoping.

Werte werden im Ruhezustand mit demselben Schlüssel und derselben Cipher wie Ihre Umgebungsvariablen selbst verschlüsselt, so dass ein Snapshot ein Geheimnis nie leichter erreichbar macht als die Variable, von der es stammt.

Was ein Snapshot nicht enthält

Dies ist der Teil, den Sie lesen sollten, bevor Sie sich darauf verlassen.

• Ihr Git-Repository. Es lebt bei Ihrem Git-Provider und gehört Ihnen. Orbit kopiert es nicht.
• Blob-Store-Objekte. Ihr Blob-Speicher ist bereits dauerhaft und ist nicht Teil eines Snapshots.
• Build-Artefakte. Erfolgreiche Builds werden unter dem Deployment-Aufbewahrungsfenster Ihres Plans beibehalten, was eine separate Einstellung auf dem Projekt ist. Das Wiederherstellen eines Snapshots stellt keinen Build wieder her, und das Rollback einer Deployment stellt keine Konfiguration oder Umgebungsvariablen wieder her. Siehe Rolling Back a Deployment.
• Datenbanken, Protokolle, Analysen oder irgendetwas, das Ihre Anwendung zur Laufzeit schreibt.

Wie lange Snapshots aufbewahrt werden

Dreißig Nächte, bei jedem Plan. Danach wird ein Snapshot automatisch entfernt.

Es gibt eine absichtliche Ausnahme. Die drei neuesten Snapshots werden immer beibehalten, auch nachdem sie dreißig Nächte überschritten haben. Ein Projekt, das Sie zwei Monate lang nicht angerührt haben, würde sonst jeden Snapshot in derselben Nacht ablaufen lassen und Sie in genau dem Moment, in dem Sie schließlich einen brauchen, ohne Wiederherstellungsmöglichkeit lassen.

Einen Snapshot wiederherstellen

1. Öffnen Sie Ihr Projekt in Orbit.
2. Öffnen Sie Settings, dann Snapshots.
3. Suchen Sie die Nacht, die Sie möchten. Jede Zeile zeigt, wie viele Config-Einträge und Umgebungsvariablen sie enthält, und wann sie entfernt werden.
4. Klicken Sie auf Restore this snapshot.
5. Geben Sie die Bestätigungsphrase genau wie angezeigt ein. Sie nennt Ihr Projekt und die Nacht, die Sie wiederherstellen, zum Beispiel restore my-blog 2026-08-30.
6. Klicken Sie auf Restore now.

Zum Wiederherstellen ist die Rolle Owner oder Admin auf dem Konto erforderlich, das das Projekt besitzt. Jeder, der das Projekt sehen kann, kann seine Snapshot-Historie lesen.

Was eine Wiederherstellung tatsächlich tut

Eine Wiederherstellung versetzt Ihr Projekt in den Zustand dieser Nacht zurück. Das bedeutet, dass es keine Zusammenführung ist:

• Einträge und Variablen, die damals existierten und jetzt fehlen, werden neu erstellt, mit ihren ursprünglichen Werten;
• Einträge und Variablen, deren Werte sich seitdem geändert haben, werden zurückgesetzt;
• Einträge und Variablen, die Sie nach dieser Nacht hinzugefügt haben, werden entfernt.

Der Bildschirm zeigt Ihnen danach genau, was geschah: wie viele hinzugefügt, wie viele geändert und wie viele entfernt wurden, für Config-Store und Umgebungsvariablen separat.

Eine Wiederherstellung rückgängig machen

Bevor eine Wiederherstellung etwas schreibt, erstellt Orbit einen Snapshot des Zustands, den es überschreiben wird. Er wird in Ihrer Liste als Before a restore-Zeile angezeigt, und der Bestätigungsbildschirm benennt ihn, wenn die Wiederherstellung abgeschlossen ist.

Wenn Sie also die falsche Nacht wiederherstellen, stellen Sie diese Zeile wieder her und Sie sind zurück, wo Sie begonnen haben. Nichts an einer Wiederherstellung ist endgültig.

Nach Wiederherstellung von Umgebungsvariablen

Eine laufende Deployment hält die Umgebungsvariablen, mit denen sie erstellt und gestartet wurde. Das Wiederherstellen dieser Variablen ändert das, was Ihre nächste Deployment verwenden wird, also müssen Sie neu bereitstellen, wenn Sie die wiederhergestellten Werte live benötigen. Das Projekt zeigt ein Banner an, wenn sich Ihre Konfiguration seit der letzten Deployment geändert hat.

Jede Variable, die eine Wiederherstellung erstellt, ändert oder entfernt, wird in der Umgebungsvariablen-Historie des Projekts aufgezeichnet, mit wer es getan hat und wann, genau wie eine manuelle Änderung.

Häufig gestellte Fragen

Wann wird der Snapshot ausgeführt? Täglich um 04:00 UTC, als Teil desselben nächtlichen Durchlaufs, der alte Build-Artefakte löscht.

Kann ich einen On-Demand erstellen? Nicht vom Bildschirm heute. Eine Wiederherstellung erstellt immer erst einen, so dass der Zustand vor jeder Wiederherstellung immer erfasst wird.

Kostet ein Snapshot etwas? Nein. Snapshots sind in jedem Plan enthalten, und der Config-Store selbst ist kostenlos zu lesen und zu schreiben.

Wird das Wiederherstellen ein Geheimnis offenbaren, das ich als nur-Schreib markiert habe? Nein. Eine Wiederherstellung stellt den Wert wieder her; sie zeigt ihn nicht an. Eine nur-Schreib-Variable bleibt nur-Schreib.