Zum Hauptinhalt springen
Version: Weekly Build

Managed-Service-Backups

Codesphere ermöglicht es dir, automatische Backups für deine Managed Services zu aktivieren, um Datenverlust zu verhindern. Diese Seite behandelt die allgemeinen Backup-Konzepte, die für alle Managed Services gelten. Provider-spezifische Konfigurationsbeispiele und Einschränkungen sind auf den jeweiligen Provider-Seiten dokumentiert.

Zentrale Konzepte​

  • Backup Store: Der externe Speicherort, an dem deine Backups gespeichert werden. Das kann ein externer S3-kompatibler Dienst (wie AWS S3) oder ein Codesphere S3 Managed Service sein.
  • Aufbewahrungsdauer: Die Anzahl der Tage, die ein Backup aufbewahrt wird, bevor es von Codesphere automatisch gelöscht wird (deleteRetentionDays).
  • Intervall: Wie oft ein neues Backup erstellt wird, gemessen in Stunden (intervalH). Codesphere übernimmt die Planung automatisch.
  • Wiederherstellung: Das Erstellen eines neuen Managed Service im exakten Zustand eines vorherigen Backups oder Zeitpunkts.

Provider-Fähigkeiten prüfen​

Nicht alle Managed Services unterstützen Backups oder Point-in-Time-Recovery. Um zu sehen, ob ein Provider dies unterstützt, kannst du den API-Endpunkt /managed-services/providers prüfen. Das capabilities-Objekt listet zwei bestimmte Features auf:

  • backups: Der Provider unterstützt das Erstellen automatischer Backups und die Wiederherstellung eines Dienstes in den exakten Zustand zum Zeitpunkt eines bestimmten Backups.
  • pointInTimeRecovery: Zusätzlich zu Standard-Backups unterstützt der Provider die Wiederherstellung eines Dienstes zu einem beliebigen Zeitpunkt (z. B. einer bestimmten Minute) zwischen zwei Backups.

Wenn pointInTimeRecovery true ist, ist auch die Fähigkeit backups true.

Du kannst die Fähigkeiten auch in der UI prüfen: Die Provider-Detailseite, die sich öffnet, wenn du auf einer Provider-Karte im Katalog auf Start setup klickst, listet sie ebenfalls auf.

Backups werden derzeit für PostgreSQL, Babelfish und DocumentDB unterstützt und können in jedem S3-kompatiblen Backup Store gespeichert werden.

Backups aktivieren​

Du kannst Backups beim Erstellen eines neuen Managed Service oder durch Aktualisieren eines bestehenden aktivieren – entweder in der UI oder über die API.

Über die UI​

Dienste, die Backups unterstützen, haben einen eigenen Backups-Tab im Service-Details-Sheet. Dieselben Einstellungen sind auch während der Diensterstellung verfügbar.

  1. Öffne die Service-Details, indem du in deinem Team auf einen Managed Service klickst
  2. Navigiere zum Backups-Tab
  3. Schalte Automatic Backups ein, um Backups zu aktivieren
  4. Konfiguriere die folgenden Einstellungen:
    • Backup Frequency: Wie oft Backups erstellt werden (in Stunden)
    • Retention Period: Wie viele Tage Backups vor der automatischen Löschung aufbewahrt werden
    • Storage Destination: Endpunkt, Zugangsdaten und Pfad deines S3-kompatiblen Backup Stores
  5. Klicke auf Save, um deine Änderungen zu übernehmen

Über die API​

Gib den backups-Block im Request-Body mit enabled: true, deinem intervalH, deleteRetentionDays sowie deiner Speicher-config und deinen secrets an. Das funktioniert sowohl beim Erstellen eines neuen Dienstes (POST) als auch beim Aktualisieren eines bestehenden (PATCH).

info

Die Werte, die du für config und secrets angibst (sowohl im backups-Block als auch im recoverFrom-Block weiter unten), können sich zwischen Providern unterscheiden. Codesphere validiert sie gegen das vom Provider definierte backups.configSchema und backups.secretsSchema. Du kannst diese Schemas in der Antwort des API-Endpunkts /managed-services/providers einsehen und konkrete Beispiele in der Provider-Dokumentation finden.

Backup-Verlauf ansehen​

Über die UI​

Der Abschnitt Restore im Backups-Tab zeigt eine Liste aller abgeschlossenen Backups mit:

  • Backup ID: Eindeutiger Bezeichner des Backups
  • Start Time: Wann das Backup gestartet wurde
  • Finish Time: Wann das Backup erfolgreich abgeschlossen wurde

Über die API​

Liste deine Managed Services auf und prüfe das backups.entries-Array des Dienstes, der dich interessiert:

curl "https://api.codesphere.com/managed-services?team=YOUR_TEAM_ID" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": "8316ee2f-87f8-424e-b925-7382dc50d662",
  "name": "my-postgres",
  "backups": {
    "enabled": true,
    "intervalH": 12,
    "deleteRetentionDays": 30,
    "entries": [
      {
        "id": "0d95627e-2adf-4f04-9b3d-08d258f978c6",
        "scheduledAt": "2026-07-12T19:38:49.410Z",
        "initiatedAt": "2026-07-12T19:38:49.410Z",
        "confirmedAt": "2026-07-12T19:38:49.410Z"
      }
    ]
  }
}

Jeder Backup-Eintrag enthält die Backup-id (die du beim Wiederherstellen als Backup-ID in recoverFrom übergeben kannst), wann es geplant und gestartet wurde, sowie confirmedAt – den Zeitpunkt, zu dem das Backup im Backup Store bestätigt wurde.

Aus einem Backup wiederherstellen (Recovery)​

Das Wiederherstellen eines Backups in Codesphere erstellt immer einen neuen Managed Service, anstatt die Daten an Ort und Stelle zu ersetzen. Der bestehende Managed Service bleibt unangetastet und vollständig unabhängig.

Um ein Backup wiederherzustellen, erstellst du einen neuen Managed Service und verwendest die Eigenschaft recoverFrom, um entweder eine bestimmte Backup-ID anzugeben oder – falls der Provider Point-in-Time-Recovery unterstützt – eine vorherige Managed-Service-ID mit einem Wiederherstellungszeitstempel.

info

Beim Wiederherstellen ist der backups-Block nicht zwingend erforderlich. Er steuert nur, ob der wiederhergestellte Dienst Backups von sich selbst erstellt.

Konkrete Wiederherstellungsbeispiele findest du in der Provider-Dokumentation.

Ein manuelles Backup auslösen​

Du kannst ein sofortiges On-Demand-Backup für einen Dienst planen, bei dem automatische Backups aktiviert sind. Manuelle Backups werden außerhalb des regulären Zeitplans erstellt und beeinflussen deine konfigurierte Backup-Frequenz nicht.

Über die UI​

Klicke im Backups-Tab deiner Service-Details auf die Schaltfläche Backup Now. Die Schaltfläche ist deaktiviert, bis automatische Backups aktiviert und gespeichert wurden.

Über die API​

Verwende den POST-Endpunkt, um ein Backup zu planen:

curl -X POST "https://api.codesphere.com/managed-services/YOUR_SERVICE_ID/backups" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

info

Wie beim Aktivieren von Backups müssen die provider-spezifischen config und secrets für deinen Backup Store im Request-Body angegeben werden. Sie werden gegen das backups.configSchema und backups.secretsSchema des Providers validiert – konkrete Beispiele findest du in der Provider-Dokumentation.

Haftungsausschlüsse und Einschränkungen​

Wenn du Managed-Service-Backups verwendest, beachte bitte Folgendes:

  • Nutzerverantwortung für S3-Speicher: Verschlüsselung und Redundanz der Backups liegen in der Verantwortung des Nutzers. Du musst sicherstellen, dass der von dir konfigurierte S3-Speicher die Sicherheits- und Redundanzanforderungen deiner Organisation erfüllt.
  • Bucket-Kapazität: Es liegt in deiner Verantwortung, dafür zu sorgen, dass der Backup Store über genügend freien Speicherplatz verfügt. Wenn der Ziel-Bucket keinen Speicherplatz mehr hat oder ein Kontingent erreicht, schlagen Backups fehl.
  • Backup-Zeitpunkt: Es gibt keine Garantie für den genauen Zeitpunkt, zu dem ein geplantes Backup ausgeführt wird. Die tatsächliche Erstellung des Backups kann je nach Systemauslastung und Netzwerkbedingungen um einige Minuten verzögert sein.