Einzelregions-Bereitstellung 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 enthält 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

In Ihrer Konfiguration kann sich die Cassandra-Sicherung entweder in Cloud Storage oder auf einem Remote-Server befinden. Führen Sie in beiden Fällen die folgenden Schritte aus, um wiederherzustellen:

Prüfen Sie die Hybridversion.
```
apigeectl version
```
Achten Sie darauf, dass es sich um die Version handelt, mit der die Sicherungsdateien im Speicher erstellt wurden.
Tipp: Führen Sie apigeectl-Befehle zuerst mit dem --dry-run=true-Flag aus, um nach apigeectl-Fehlern zu suchen.
Achten Sie darauf, dass der wiederherzustellende Kubernetes-Cluster keine vorherige Apigee-Hybridinstallation hat. Wenn Sie im vorhandenen Cluster wiederherstellen, verwenden Sie folgenden Befehl, um die vorhandene Apigee-Hybridinstallation zu löschen:
```
apigeectl delete --all -f overrides.yaml
```

Öffnen Sie Ihre overrides.yaml-Datei und legen Sie die restore-Attribute auf die gewünschten Werte fest:

Parameter

namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
cassandra:
  ...
  restore:
    enabled: true
    keyFile: "PATH_TO_PRIVATE_KEY_FILE"
    server: "BACKUP_SERVER_IP"
    storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
    cloudProvider: "HYBRID"  # required verbatim "HYBRID" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: true
    keyFile: "PATH_TO_PRIVATE_KEY_FILE"
    server: "BACKUP_SERVER_IP"
    storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
    cloudProvider: "HYBRID" # required verbatim "HYBRID" (all caps)
    schedule: "SCHEDULE"

Beispiel

namespace: apigee
cassandra:
...
  restore:
    enabled: true
    keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
    server: "34.56.78.90"
    storageDirectory: "/home/apigee/cassbackup"
    cloudProvider: "HYBRID"
    snapshotTimestamp: "20201001183903"
  ...
  backup:
    enabled: true
    keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
    server: "34.56.78.90"
    storageDirectory: "/home/apigee/cassbackup"
    cloudProvider: "HYBRID"
    schedule: "0 2 * * *"
  ...

Wobei:

Attribut	Beschreibung
`namespace`	`YOUR_RESTORE_NAMESPACE` Namespace zur Wiederherstellung. Verwenden Sie den Namespace wie im ursprünglichen Cluster.
`restore:enabled`	Die Wiederherstellung ist standardmäßig deaktiviert. Sie müssen dieses Attribut auf `true` festlegen.
`restore:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` Der Pfad in Ihrem lokalen Dateisystem zur privaten SSH-Schlüsseldatei, die Sie in dem Schritt, in dem Sie das SSH-Schlüsselpaar erstellt haben, mit `ssh_key` benannt haben.
`restore:server`	`BACKUP_SERVER_IP` Die IP-Adresse des Sicherungsservers.
`restore:storageDirectory`	`BACKUP_DIRECTORY` Der Name des Sicherungsverzeichnisses auf dem Sicherungsserver. Dies muss ein Verzeichnis innerhalb `home/apigee` (das Sicherungsverzeichnis heißt `cassandra_backup` in dem Schritt, in dem Sie das Sicherungsverzeichnis erstellt haben) sein.
`restore:cloudProvider`	`HYBRID` Das Attribut `cloudProvider: "HYBRID"` ist erforderlich.
`restore:snapshotTimestamp`	`TIMESTAMP` Der Zeitstempel des wiederherzustellenden Backup-Snapshots. Rufen Sie `dbStorageBucket` auf und sehen Sie sich die Dateien im Bucket an, wenn Sie prüfen möchten, welche Zeitstempel verwendet werden können. Jeder Dateiname enthält einen Zeitstempelwert. Beispiel: `backup_20210203213003_apigee-cassandra-default-0.tgz` Dabei ist `20210203213003` der `snapshotTimestamp`-Wert, den Sie verwenden würden, wenn Sie die Backups zu dieser Zeit wiederherstellen wollten.
`backup:enabled`	Die Sicherung ist standardmäßig deaktiviert. Sie müssen dieses Attribut auf `true` festlegen.
`backup:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` Der Pfad in Ihrem lokalen Dateisystem zur privaten SSH-Schlüsseldatei, die Sie in dem Schritt, in dem Sie das SSH-Schlüsselpaar erstellt haben, mit `ssh_key` benannt haben.
`backup:server`	`BACKUP_SERVER_IP` Die IP-Adresse des Sicherungsservers.
`backup:storageDirectory`	`BACKUP_DIRECTORY` Der Name des Sicherungsverzeichnisses auf dem Sicherungsserver. Dies muss ein Verzeichnis innerhalb `home/apigee` (das Sicherungsverzeichnis heißt `cassandra_backup` in dem Schritt, in dem Sie das Sicherungsverzeichnis erstellt haben) sein.
`backup:cloudProvider`	`HYBRID` Das Attribut `cloudProvider: "HYBRID"` ist erforderlich.
`backup:schedule`	`SCHEDULE` Die Zeit, zu der das Backup startet, angegeben in der Standard-Crontab-Syntax. Standard: `0 2 * * ` Hinweis:* Planen Sie kein Backup, das kurz nach dem Anwenden der Backup-Konfiguration auf den Cluster startet. Wenn Sie die Backup-Konfiguration anwenden, erstellt Kubernetes die Cassandra-Knoten neu. Wenn das Backup vor dem Neustart der Knoten (möglicherweise mehrere Minuten) startet, schlägt die Sicherung fehl.

Hinweis: Apigee stellt Cassandra aus einer Cloud Storage-Sicherung oder einer Remote-Serversicherung auf Basis der backup-Konfiguration in der overrides.yaml-Datei wieder her.

Erstellen Sie eine neue Hybrid-Laufzeitbereitstellung. Damit wird ein neuer Cassandra-Cluster erstellt und die Backupdaten werden im Cluster wiederhergestellt:
```
${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml
```
```
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
```
Hinweis: Das Flag --restore wurde in Hybrid-Version 1.6.6 eingeführt. Wenn Sie eine ältere Version verwenden, führen Sie den folgenden Befehl ohne das Flag --restore aus.
```
${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore
```
```
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
```
Prüfen Sie den Fortschritt des Wiederherstellungsjobs und ob apigeeds und alle anderen Pods aktiv sind:
- So prüfen Sie apigeeds:
```
kubectl get apigeeds -n apigee
```
- So prüfen Sie alle anderen Pods:
```
kubectl get pods -n apigee
```

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:
```
./apigeectl apply -f ../overrides-restore.yaml
```