Auf dieser Seite wird das Wiederherstellen von Cassandra in einer einzelnen Region beschrieben.
In einer Einzelregions-Bereitstellung wird Apigee Hybrid in einem einzelnen Rechenzentrum oder einer Region bereitgestellt. Wenn Sie in Ihrer Bereitstellung mehrere Apigee-Organisationen haben, werden bei der Wiederherstellung Daten aller Organisationen wiederhergestellt.
In einer Einrichtung mit mehreren Organisationen können Sie eine bestimmte Organisation nicht wiederherstellen.
Region aus einem Backup wiederherstellen
Aktualisieren Sie die Cassandra-Wiederherstellungsdetails in der Datei overrides.yaml:
Namespace zur Wiederherstellung. Verwenden Sie denselben Namespace wie im ursprünglichen Cluster.
cassandra:hostNetwork
hostNetwork ist erforderlich und sollte immer auf false gesetzt werden.
restore:enabled
Die Wiederherstellung ist standardmäßig deaktiviert. Sie müssen dieses Attribut auf true festlegen.
restore:serviceAccountPath
SA_JSON_FILE_PATH
Der Pfad in Ihrem Dateisystem zum Dienstkonto, das Sie für die Sicherung erstellt haben.
restore:dbStorageBucket
CLOUD_STORAGE_BUCKET_NAME
Der Name eines Google Cloud Storage-Buckets, in dem Sicherungsarchive für die Datenwiederherstellung gespeichert werden.
restore:cloudProvider
GCP
Das Attribut cloudProvider: "GCP" ist erforderlich.
restore:snapshotTimestamp
TIMESTAMP
Der Zeitstempel des wiederherzustellenden Backup-Snapshots. Wenn Sie prüfen möchten, welche Zeitstempel verwendet werden können, rufen Sie dbStorageBucket auf und sehen Sie sich die Dateien im Bucket an. Jeder Dateiname enthält einen Zeitstempelwert. Beispiele:
backup_20210203213003_apigee-cassandra-default-0.tgz
Dabei ist 20210203213003 der snapshotTimestamp-Wert, den Sie verwenden würden, wenn Sie die Sicherungen zu diesem Zeitpunkt wiederherstellen wollten.
backup:enabled
Sie sollten dieses Attribut auf false setzen, falls es zuvor auf true gesetzt war.
Wenn Sie zu Beginn keinen sauberen Cluster haben, folgen Sie der Dokumentation Hybridregion für Helm außer Betrieb nehmen, um Ihre vorhandene Hybrid-Installation in einen sauberen Zustand zu versetzen. Sie können den Zertifikatsmanager installiert lassen. Dadurch erhalten Sie den gleichen Zustand, als hätten Sie das Einrichtungshandbuch für die Helm-Laufzeit bis zum Beginn von Schritt 11 befolgt.
Prüfen Sie, ob in den Apigee-Namespaces noch Pods vorhanden sind:
kubectl get pods -n APIGEE_NAMESPACE
Wenn Sie eine CSI-Sicherung verwenden, prüfen Sie, ob Sie die Volume-Snapshots sehen, die Sie für die Wiederherstellung verwenden möchten. Führen Sie dazu Folgendes aus:
kubectl get volumesnapshot -n APIGEE_NAMESPACE
Installieren Sie alle Hybridkomponenten nacheinander, wie unter Schritt 10: Apigee Hybrid über Helm installieren beschrieben. Beachten Sie, dass der Pod apigee-cassandra-restore erstellt wird, sobald Sie den Befehl zur Installation von datastore ausführen. Er wechselt jedoch erst nach der Installation der Komponente apigee-org in den Status running.
Weitere Informationen zur Cassandra-Sicherung und -Wiederherstellung finden Sie unter Cassandra-Sicherungsübersicht.
Prüfen Sie den Fortschritt des Wiederherstellungsjobs und ob apigeeds und alle anderen Pods aktiv sind:
Prüfen Sie apigeeds:
kubectl get apigeeds -n APIGEE_NAMESPACE
Prüfen Sie alle anderen Pods:
kubectl get pods -n APIGEE_NAMESPACE
Nach Abschluss der Wiederherstellung und der Bestätigung, dass die Laufzeitkomponenten fehlerfrei sind, empfehlen wir, eine Sicherung auf dem Cluster zu konfigurieren:
Entfernen Sie die restore-Konfiguration aus der overrides-restore.yaml-Datei.
Fügen Sie der overrides-restore.yaml-Datei die backup-Konfiguration hinzu.
Wenden Sie die backup-Konfiguration mit diesem Befehl an:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-28 (UTC)."],[[["\u003cp\u003eThis guide explains how to restore Cassandra data in an Apigee hybrid single-region deployment, which impacts all organizations within that deployment.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, determine if you need to preserve the existing setup for troubleshooting, and if so, delete all \u003ccode\u003eorg\u003c/code\u003e and \u003ccode\u003eenv\u003c/code\u003e components except the Apigee controller, then restore in a new cluster.\u003c/p\u003e\n"],["\u003cp\u003eRestoration is initiated by setting \u003ccode\u003erestore: enabled\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file, along with providing details like the service account path, storage bucket, cloud provider, and the snapshot timestamp.\u003c/p\u003e\n"],["\u003cp\u003eYou must ensure \u003ccode\u003ebackup: enabled\u003c/code\u003e is set to \u003ccode\u003efalse\u003c/code\u003e in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e during the restore process to avoid conflicts.\u003c/p\u003e\n"],["\u003cp\u003eAfter the restore process completes, you should remove the \u003ccode\u003erestore\u003c/code\u003e configuration and add the \u003ccode\u003ebackup\u003c/code\u003e configuration to the \u003ccode\u003eoverrides-restore.yaml\u003c/code\u003e to re-enable backups.\u003c/p\u003e\n"]]],[],null,["# Restoring in a single region\n\n| You are currently viewing version 1.14 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nThis page describes how to restore Cassandra in a single region.\n\nIn a single region deployment, Apigee hybrid is deployed in a single data center or a region. If you\nhave multiple Apigee organizations in your deployment, the restore process restores data for all the organizations.\nIn a multi-organization setup, you cannot restore a specific organization.\n| **Note** : Before you begin restoring a single region, consider whether the following prerequisite steps are applicable:\n|\n| - If you want to preserve an existing setup for troubleshooting and root cause analysis (RCA), you should delete all the `org` and `env` components from the Kubernetes cluster *except* the Apigee controller, and then retain the cluster. The cluster will contain the existing Apigee datastore (Cassandra) which you can use for troubleshooting. Create a new Kubernetes cluster and then restore Cassandra in the new cluster.\n| - If your hybrid installation was set up with multiple organizations, get the overrides files for each organization before proceeding with restore in a single region. You can add the restore configuration as described in [Step 3](#step3) to any **one** of the overrides files. Do not add the restore configuration to any other overrides file.\n\nRestoring a region from a backup\n--------------------------------\n\n1. Update the Cassandra restore details in the `overrides.yaml` file:\n\n ```actionscript-3\n namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.\n cassandra:\n hostNetwork: false\n ...\n restore:\n enabled: true\n serviceAccountPath: \"\u003cvar translate=\"no\"\u003eSA_JSON_FILE_PATH\u003c/var\u003e\"\n dbStorageBucket: \"\u003cvar translate=\"no\"\u003eCLOUD_STORAGE_BUCKET_NAME\u003c/var\u003e\"\n cloudProvider: \"GCP\" # required verbatim \"GCP\" (all caps)\n snapshotTimestamp: \"\u003cvar translate=\"no\"\u003eTIMESTAMP\u003c/var\u003e\"\n ...\n backup:\n enabled: false\n ...\n ```\n\n\n Where:\n\n | **Note:** In case you are using **CSI backup** , please follow the **example restore config** in the [CSI backup and restore](/apigee/docs/hybrid/v1.14/cassandra-csi-backup-restore#example-restore-config) documentation.\n2. In case you do not have a clean cluster to start out with, follow the\n [Decommission a hybrid region for helm](/apigee/docs/hybrid/v1.14/decommission-region#helm)\n documentation to bring your existing Hybrid installation into a clean state\n (you can leave the **Cert Manager** installed). This would bring you to an equal state\n as if you would have followed [Helm runtime setup manual](/apigee/docs/hybrid/v1.14/install-create-cluster)\n until the beginning of Step 11.\n\n3. Verify there are no pods remaining in the Apigee namespace:\n\n ```\n kubectl get pods -n APIGEE_NAMESPACE\n ```\n4. If you are using CSI backup, make sure that you can see\n the volumesnapshots you want to use for the restoration process by running:\n\n ```\n kubectl get volumesnapshot -n APIGEE_NAMESPACE\n \n ```\n5. Install all Hybrid components one by one as described in\n [Step 10: Install Apigee hybrid using Helm](/apigee/docs/hybrid/v1.14/install-helm-charts). Note that the `apigee-cassandra-restore` pod will get\n created once you run the command to install the `datastore`, but it will only\n go into `running` state after you install the `apigee-org` component.\n\nSee [Cassandra backup overview](/apigee/docs/hybrid/v1.14/cassandra-backup-overview) for more details on Cassandra backup and restore.\n\nVerify the restoration job progress and confirm that `apigeeds` and all the other pods are up:\n\n1. Check `apigeeds`: \n\n ```\n kubectl get apigeeds -n APIGEE_NAMESPACE\n ```\n2. Check all other pods: \n\n ```\n kubectl get pods -n APIGEE_NAMESPACE\n ```\n\nUpon successful completion of the restore and confirmation that the runtime components are healthy,\nwe recommend configuring a backup on the cluster:\n\n1. Remove the `restore` configuration from the `overrides-restore.yaml` file.\n2. Add the `backup` configuration to the `overrides-restore.yaml` file.\n3. Apply the `backup` configuration with the following command: \n\n ```\n helm upgrade datastore apigee-datastore/ \\\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n -f overrides-restore.yaml\n ```\n\n\u003cbr /\u003e\n\n| **Warning:** See [known issue 391861216](/apigee/docs/release/known-issues#391861216) affecting Apigee Hybrid and Cassandra after restore using a remote server or Cloud Storage."]]
