In einer einzelnen Region wiederherstellen

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.

Hinweis: Bevor Sie mit dem Wiederherstellen einer einzelnen Region beginnen, sollten Sie prüfen, ob folgende erforderlichen Schritte anwendbar sind:

Wenn Sie eine vorhandene Einrichtung zur Fehlerbehebung und Ursachenanalyse (RCA, Root Cause Analysis) beibehalten möchten, löschen Sie alle org- und env-Komponenten aus dem Kubernetes-Clusteraußer dem Apigee-Controller und behalten den Cluster bei. Der Cluster verfügt über den vorhandenen Apigee-Datenspeicher (Cassandra), den Sie für die Fehlerbehebung verwenden können. Erstellen Sie einen neuen Kubernetes-Cluster und stellen Sie dann Cassandra im neuen Cluster wieder her.
Wenn Ihre Hybridinstallation mit mehreren Organisationen eingerichtet wurde, rufen Sie die Überschreibungsdateien für die einzelnen Organisationen ab, bevor Sie mit der Wiederherstellung in einer einzelnen Region fortfahren. Sie können die Wiederherstellungskonfiguration wie in Schritt 3 beschrieben einer beliebigen Überschreibungsdatei hinzufügen. Fügen Sie die Wiederherstellungskonfiguration keiner weiteren Überschreibungsdatei hinzu.

Region aus einem Backup wiederherstellen

Aktualisieren Sie die Cassandra-Wiederherstellungsdetails in der Datei overrides.yaml:

namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_NAME"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: false
  ...

Wobei:

Attribut	Beschreibung
`namespace`	`YOUR_RESTORE_NAMESPACE` 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. Hinweis: Ab Hybridversion 1.13 muss der Bucket-Name nicht mehr mit `gs://` vorangestellt werden. Die Unterstützung für dieses Präfix wurde eingestellt und wird in zukünftigen Releases entfernt.
`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. Hinweis: Die Sicherung darf bei der Wiederherstellung nicht aktiviert sein.

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:

helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides-restore.yaml