Sicherung und Wiederherstellung

Die Anyy-Sicherung erfasst einen konsistenten Profilschnappschuss. Die Wiederherstellung veröffentlicht immer in einem neuen, noch nicht vorhandenen Profilverzeichnis; sie überschreibt niemals aktive Daten.

Eine Sicherung erstellen

anyy backup create

Das Standardarchiv wird mit einem Zeitstempelnamen im Sicherungsbereich des Profils geschrieben. Wählen Sie bei Bedarf ein anderes Ziel:

anyy backup create --output /secure/path/anyy-backup.tar.gz

Ist Gateway erreichbar, fordert der Befehl die residente Laufzeit auf, den konsistenten Schnappschuss zu erstellen. Ist es offline, muss Anyy vor dem Lesen veränderlichen Zustands exklusiven Profilbesitz erlangen.

Was enthalten ist

Das Archiv kann Profilkonfiguration, Rollen- und Skill-Dateien, Workspace- und Erinnerungsdaten, Zeitpläne, Kanalkonfiguration, einen Datenbankschnappschuss und referenzierte dauerhafte Objekte oder Artefakte enthalten.

Eine Sicherung erfasst ein ausgewähltes Profil; sie bündelt weder benachbarte Profile noch die installierte Anyy-Programmdatei. Sichern Sie jedes Profil separat.

Temporäre Laufzeitdateien sind ausgeschlossen. Symbolische Links werden abgelehnt, statt Inhalten außerhalb des Profils zu folgen.

Verwaltete Zugangsdaten-Verzeichnisse nur nach ausdrücklicher Auswahl

Standardmäßig lässt die Sicherung die verwalteten Verzeichnisse secrets/ und mcp/oauth/ aus. Nehmen Sie deren Profilgeheimnisse und unterstütztes MCP-/OAuth-Material ausdrücklich auf:

anyy backup create --include-secrets

Dieses Flag steuert diese verwalteten Verzeichnisse; es durchsucht nicht jede enthaltene Datei nach Geheimnissen. Konfiguration und Benutzerdateien werden mit ihrem Inhalt aufgenommen: Direkt eingetragene MCP-Umgebungs-/Headerwerte in config.yaml oder Geheimnisse im Workspace und anderen erfassten Dateien können auch ohne --include-secrets ins Archiv gelangen. Die Sicherung redigiert nicht das gesamte Archiv.

Jede Sicherung als vertrauliche Daten schützen

Verschlüsseln Sie Archive, beschränken Sie den Zugriff und laden Sie sie nicht auf gewöhnliche Dateifreigaben oder in einen Issue-Tracker hoch. Das Weglassen verwalteter Zugangsdaten-Verzeichnisse garantiert kein geheimnisfreies Archiv.

Sicherungen auflisten

anyy backup list
anyy backup list --json

Der Auflistungsbefehl meldet erkannte Archive am Sicherungsspeicherort des Profils. Ein Archiv an einem eigenen Pfad kann weiterhin durch direkte Angabe wiederhergestellt werden.

Sicher wiederherstellen

Wählen Sie ein noch nicht vorhandenes Zielverzeichnis:

anyy backup restore \
  --archive /secure/path/anyy-backup.tar.gz \
  --target-home /path/to/new-profile

Vor dem Veröffentlichen des Ziels prüft die Wiederherstellung Manifest, Dateihashes, verfügbaren Speicher, Pfade und Archivstruktur. Sie bereitet das Ergebnis neben dem Ziel vor, baut erforderliche Indizes und Audit-Zustand neu auf und veröffentlicht es dann atomar.

Nach der Wiederherstellung:

anyy status --home /path/to/new-profile
anyy doctor --home /path/to/new-profile

Verwenden Sie das wiederhergestellte Home für Befehle und TUI ausdrücklich:

anyy --home /path/to/new-profile
anyy dashboard --home /path/to/new-profile

Es gibt keinen Profilimport-/Registrierungsbefehl. Um als benanntes Profil wiederherzustellen, wählen Sie das noch nicht vorhandene kanonische Ziel BASE_HOME/profiles/NAME, prüfen Sie es und führen Sie dann anyy --profile-root BASE_HOME profile use NAME aus. Führen Sie nicht zuerst profile create NAME aus: Dies erstellt das Verzeichnis, und die Wiederherstellung lehnt es ab.

Wiederherstellungsregeln

• Wählen Sie niemals das aktuelle Profil-Home als --target-home.
• Stellen Sie niemals über einem bereits vorhandenen Verzeichnis wieder her.
• Behalten Sie das Quellarchiv, bis das wiederhergestellte Profil status und doctor bestanden hat.
• Verbinden Sie ausgelassene Zugangsdaten erneut, bevor Sie ausgehende Kanäle oder kostenpflichtige Anbieter aktivieren.
• Testen Sie regelmäßig eine Wiederherstellung; ein ungeprüftes Archiv ist nur ein Sicherungsversuch.

Fehlerbehebung

Symptom	Erklärung
Die Sicherung verweigert den Offline-Modus	Ein aktiver Prozess besitzt weiterhin das Profil; verwenden Sie den residenten Weg oder stoppen Sie ihn
Die Wiederherstellung meldet ein vorhandenes Ziel	Wählen Sie einen neuen leeren Pfad; eine überlagernde Wiederherstellung wird bewusst nicht unterstützt
Hash- oder Manifestprüfung schlägt fehl	Umgehen Sie sie nicht; verwenden Sie ein anderes nachweislich intaktes Archiv
Wiederhergestellte Anbieter können sich nicht authentifizieren	Die Sicherung hat möglicherweise verwaltete Zugangsdaten ausgelassen oder hängt von nicht verfügbaren Zugangsdatenreferenzen ab; verbinden Sie sie erneut