Zum Hauptinhalt springen
Version: Weekly Build

Managed Service Backups

Codesphere ermöglicht es, automatisierte Backups für Managed Services zu aktivieren, um Datenverlust vorzubeugen. Diese Seite behandelt die allgemeinen Backup-Konzepte, die für alle Managed Services gelten. Anbieterspezifische Konfigurationsbeispiele und Einschränkungen sind auf den jeweiligen Anbieterseiten dokumentiert.

Grundlegende Konzepte​

  • Backup Store: Der externe Speicherort, an dem Backups gesichert werden. Dies kann ein externer S3-kompatibler Dienst (wie AWS S3) oder ein Codesphere S3 Managed Service sein.
  • Aufbewahrungszeitraum: Die Anzahl an Tagen, die ein Backup aufbewahrt wird, bevor es automatisch von Codesphere gelöscht wird (deleteRetentionDays).
  • Intervall: Wie oft ein neues Backup erstellt wird, gemessen in Stunden (intervalH). Codesphere übernimmt die Zeitplanung automatisch.
  • Recovery: Die Erstellung eines neuen Managed Service im exakten Zustand eines früheren Backups oder Zeitpunkts.

Anbieterfähigkeiten prüfen​

Nicht alle Managed Services unterstützen Backups oder Point-in-Time Recovery. Um zu prüfen, ob ein Anbieter dies unterstützt, kann der /managed-services/providers API-Endpunkt abgefragt werden. Das capabilities-Objekt listet zwei spezifische Funktionen auf:

  • backups: Der Anbieter unterstützt automatisierte Backups sowie die Wiederherstellung eines Service im exakten Zustand zum Zeitpunkt eines bestimmten Backups.
  • pointInTimeRecovery: Zusätzlich zu Standard-Backups unterstützt der Anbieter die Wiederherstellung eines Service zu einem beliebigen Zeitpunkt (z. B. einer bestimmten Minute) zwischen zwei Backups.

Wenn pointInTimeRecovery den Wert true hat, ist auch die backups-Fähigkeit auf true gesetzt.

Die Fähigkeiten lassen sich auch in der Benutzeroberfläche einsehen: Die Anbieter-Detailseite, die sich beim Klick auf Start setup auf einer Anbieterkarte im Katalog öffnet, listet diese ebenfalls auf.

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

Backups aktivieren​

Backups können bei der Erstellung eines neuen Managed Service oder durch Aktualisieren eines bestehenden aktiviert werden, entweder über die Benutzeroberfläche oder über die API.

Über die Benutzeroberfläche​

Services, die Backups unterstützen, verfügen über einen eigenen Backups-Tab im Detailbereich des Service. Dieselben Einstellungen stehen auch bei der Erstellung eines Service zur Verfügung.

  1. Öffne die Service-Details, indem du auf einen Managed Service in deinem Team klickst

  2. Navigiere zum Backups-Tab

  3. Aktiviere Automatic Backups, 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 des S3-kompatiblen Backup Store

  5. Klicke auf Save, um die Änderungen zu übernehmen

Über die API​

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

info

Die Werte, die für config und secrets angegeben werden (sowohl im backups-Block als auch im recoverFrom-Block weiter unten), können je nach Anbieter variieren. Codesphere validiert sie gegen die vom Anbieter definierten Schemas backups.configSchema und backups.secretsSchema. Diese Schemas können in der Antwort des /managed-services/providers API-Endpunkts eingesehen werden, konkrete Beispiele finden sich in der jeweiligen Anbieterdokumentation.

Backup-Verlauf einsehen​

Über die Benutzeroberfläche​

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

  • Backup ID: Eindeutige Kennung des Backups
  • Start Time: Zeitpunkt, zu dem das Backup gestartet wurde
  • Finish Time: Zeitpunkt, zu dem das Backup erfolgreich abgeschlossen wurde

Über die API​

Liste deine Managed Services auf und prüfe das backups.entries-Array des gewünschten Service:

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 beim Wiederherstellen als Backup-ID in recoverFrom übergeben werden kann), den Zeitpunkt der Planung und Initiierung sowie confirmedAt — den Zeitpunkt, zu dem das Backup im Backup Store bestätigt wurde.

Wiederherstellen aus einem Backup (Recovery)​

Das Wiederherstellen eines Backups in Codesphere erstellt immer einen neuen Managed Service, anstatt die Daten am bestehenden 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 Anbieter Point-in-Time Recovery unterstützt — eine frühere Managed-Service-ID mit einem Wiederherstellungszeitpunkt.

info

Beim Wiederherstellen ist der backups-Block nicht zwingend erforderlich. Er steuert lediglich, ob der wiederhergestellte Service selbst Backups anlegt.

Konkrete Wiederherstellungsbeispiele finden sich in der Anbieterdokumentation.

Ein manuelles Backup auslösen​

Für einen Service mit aktivierten automatischen Backups kann ein sofortiges, bedarfsgesteuertes Backup geplant werden. Manuelle Backups werden außerhalb des regulären Zeitplans erstellt und beeinflussen nicht die konfigurierte Backup-Frequenz.

Über die Benutzeroberfläche​

Klicke im Backups-Tab der Service-Details auf die Schaltfläche Backup Now. Die Schaltfläche ist deaktiviert, solange automatische Backups nicht 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 auch hier die anbieterspezifischen config- und secrets-Werte für deinen Backup Store im Request-Body angegeben werden. Sie werden gegen die backups.configSchema und backups.secretsSchema des Anbieters validiert — konkrete Beispiele finden sich in der Anbieterdokumentation.

Haftungsausschlüsse und Einschränkungen​

Bei der Verwendung von Managed Service Backups sind folgende Punkte zu beachten:

  • Eigenverantwortung für S3-Speicher: Verschlüsselung und Redundanz der Backups liegen in der Verantwortung des Nutzers. Es muss sichergestellt werden, dass der konfigurierte S3-Speicher den Sicherheits- und Redundanzanforderungen der jeweiligen Organisation entspricht.
  • Bucket-Kapazität: Es liegt in der eigenen Verantwortung, sicherzustellen, dass der Backup Store über ausreichend freien Speicherplatz verfügt. Läuft der Ziel-Bucket voll oder wird ein Kontingent erreicht, schlagen Backups fehl.
  • Zeitpunkt der Backups: Es gibt keine Garantie für den exakten Zeitpunkt, zu dem ein geplantes Backup ausgeführt wird. Die tatsächliche Backup-Erstellung kann sich je nach Systemauslastung und Netzwerkbedingungen um einige Minuten verzögern.