Back-ups auf einem Remote-Server planen

Sie sehen sich gerade die Version 1.11 der Apigee Hybrid-Dokumentation an. This version is end of life. You should upgrade to a newer version. Weitere Informationen finden Sie unter Unterstützte Versionen.

Version 1.11 

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Warnung:Bei dieser Apigee Hybrid-Version gibt es ein bekanntes Problem 388608440, das sich auf Sicherungen auswirkt, bei denen HYBRID- oder GCP-Cloud-Anbieter verwendet werden. Im Leitfaden zur Fehlerbehebung für Cassandra erfahren Sie, ob Ihre Einrichtung betroffen ist und welche Schritte zur Behebung erforderlich sind.

Auf dieser Seite wird beschrieben, wie Sie Sicherungen für Cassandra ohne Cloud Storage planen. Bei dieser Methode werden Sicherungen auf einem von Ihnen angegebenen Remoteserver und nicht in einem Cloud Storage-Bucket gespeichert. Apigee verwendet SSH, um mit dem Remote-Server zu kommunizieren.

Sie müssen die Sicherungen als cron-Jobs planen. Nachdem ein Sicherungszeitplan auf Ihren Hybrid-Cluster angewendet wurde, wird regelmäßig ein Kubernetes-Sicherungsjob gemäß dem Zeitplan in der Laufzeitebene ausgeführt. Der Job löst auf jedem Cassandra-Knoten in Ihrem Hybridcluster ein Sicherungsskript aus, das alle Daten auf dem Knoten erfasst, eine (komprimierte) Archivdatei der Daten erstellt und das Archiv an den in der Datei overrides.yaml angegeben Server sendet.

Hinweis:

• Sie müssen sicherstellen, dass auf dem Dateisystem genügend Speicherplatz für die Sicherungen vorhanden ist. Außerdem sollten Sie die Häufigkeit der Sicherungen anpassen, um zu vermeiden, dass der ungenutzte Speicherplatz belegt wird. Apigee legt keine Aufbewahrungsrichtlinie für die Sicherungsdateien fest. Sie können für Ihre Installation geeignete Dateien erstellen.
• Durch das Anwenden der Sicherungskonfiguration auf den vorhandenen Cluster werden Cassandra-Pods neu gestartet.

Die folgenden Schritte enthalten gängige Beispiele für die Ausführung bestimmter Aufgaben, z. B. das Erstellen eines SSH-Schlüsselpaars. Verwenden Sie die für Ihre Installation geeigneten Methoden.

Der Vorgang besteht aus folgenden Teilen:

• Server und SSH einrichten
• Zeitplan und Ziel für Sicherung festlegen

Server und SSH einrichten

1. Geben Sie einen Linux- oder Unix-Server für Ihre Sicherungen an. Dieser Server muss über SSH von Ihrer Apigee Hybrid-Laufzeitebene erreichbar sein. Es muss genügend Speicherplatz für die Sicherungen haben.
2. Richten Sie einen SSH-Server auf dem Server ein bzw. prüfen Sie, ob ein sicherer SSH-Server konfiguriert ist.
   Achtung: Achten Sie aus Sicherheitsgründen darauf, dass der SSH-Server auf dem neuesten Stand ist.
3. Erstellen Sie ein SSH-Schlüsselpaar und speichern Sie die Datei mit dem privaten Schlüssel in einem Pfad, auf den von der Hybrid-Laufzeitebene aus zugegriffen werden kann. Sie müssen ein leeres Passwort für Ihr Schlüsselpaar verwenden. Andernfalls schlägt die Sicherung fehl. Beispiel:

   ssh-keygen -t rsa -b 4096 -C [e-mail]
     Enter file in which to save the key (/Users/exampleuser/.ssh/id_rsa): $APIGEE_HOME/hybrid-files/certs/ssh_key
     Enter passphrase (empty for no passphrase):
     Enter same passphrase again:
     Your identification has been saved in ssh_key
     Your public key has been saved in ssh_key.pub
     The key fingerprint is:
     SHA256:DWKo334XMZcZYLOLrd/8HNpjTERPJJ0mc11UYmrPvSA [e-mail]
     The key's randomart image is:
     +---[RSA 4096]----+
     |          +.  ++X|
     |     .   . o.=.*+|
     |    . o . . o==o |
     |   . . . =oo+o...|
     |  .     S +E oo .|
     |   . .   .. . o .|
     |    . . .  . o.. |
     |     .  ...o ++. |
     |      .. .. +o+. |
     +----[SHA256]-----+

   Dabei ist [e-mail] ein String. Jeder String, der im Befehl ssh-keygen auf -C folgt, wird zu einem Kommentar, der im neu erstellten Schlüssel ssh enthalten ist. Der Eingabestring kann ein beliebiger String sein. Wenn Sie einen Kontonamen im Format [e-mail] verwenden, können Sie schnell feststellen, welches Konto mit dem Schlüssel verknüpft wird.

4. Erstellen Sie auf dem Sicherungsserver ein Nutzerkonto mit dem Namen apigee. Achten Sie darauf, dass der neue apigee-Nutzer ein Basisverzeichnis unter /home hat.
5. Erstellen Sie auf dem Sicherungsserver das Verzeichnis .ssh im neuen Verzeichnis /home/apigee.
6. Kopieren Sie den öffentlichen Schlüssel (im vorherigen Beispiel ssh_key.pub) in eine Datei mit dem Namen authorized_keys im neuen Verzeichnis /home/apigee/.ssh. Beispiel:

   cd /home/apigee
   mkdir .ssh
   cd .ssh
   vi authorized_keys

7. Erstellen Sie auf dem Sicherungsserver ein Sicherungsverzeichnis im Verzeichnis /home/apigee/. Das Sicherungsverzeichnis kann ein beliebiges Verzeichnis sein, solange der Nutzer apigee Zugriff darauf hat. Beispiel:

   cd /home/apigee
   mkdir cassandra-backup

8. Testen Sie die Verbindung. Sie müssen sicherstellen, dass Ihre Cassandra-Pods über SSH eine Verbindung zu Ihrem Sicherungsserver herstellen können:
   1. Melden Sie sich in der Shell des Cassandra-Pods an. Beispiel:

      kubectl exec -it -n APIGEE_NAMESPACE APIGEE_CASSANDRA_POD -- /bin/bash

      Dabei ist APIGEE_CASSANDRA_POD der Name eines Cassandra-Pods. Ändern Sie dies in den Namen des Pods, von dem Sie eine Verbindung herstellen möchten.

   2. Stellen Sie per SSH eine Verbindung zu Ihrem Sicherungsserver her. Verwenden Sie dazu den privaten SSH-Schlüssel, der den Cassandra-Pod und die IP-Adresse des Servers bereitgestellt hat:

      ssh -i /var/secrets/keys/key apigee@BACKUP_SERVER_IP

      Hinweis: Möglicherweise wird an dieser Stelle eine Warnung angezeigt, die besagt, dass der Fingerabdruck Ihres Servers nicht erkannt wurde und Sie gefragt werden, ob Sie fortfahren möchten. Sie können an dieser Eingabeaufforderung fortfahren und die SSH-Konfiguration prüfen.

Zeitplan und Ziel für Sicherung festlegen

Zeitplan und Ziel für Sicherungen werden in der Datei overrides.yaml festgelegt.

1. Fügen Sie der Datei overrides.yaml Folgendes hinzu:

   Parameter

   cassandra:
     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-Helm

   cassandra:
     backup:
       enabled: true
       keyFile: "private.key"# path relative to apigee-datastore path
       server: "34.56.78.90"
       storageDirectory: "/home/apigee/cassbackup"
       cloudProvider: "HYBRID"
       schedule: "0 2 * * *"

   Beispiel apigeectl

   cassandra:
     backup:
       enabled: true
       keyFile: "home/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
   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. Hinweis:Bei von Helm verwalteten Installationen muss dieser Pfad relativ zum Diagrammverzeichnis apigee-datastore sein.
   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 Legen Sie für eine Remote-Serversicherung das Attribut HYBRID fest.
   backup:schedule	SCHEDULE Die Zeit, zu der das Backup startet, angegeben in der Standard-Crontab-Syntax. Die Zeiten sind in der lokalen Zeitzone des Kubernetes-Clusters angegeben. Standard: 0 2 * * * Hinweis: Planen Sie kein Backup, das kurz nach dem Anwenden der Backupkonfiguration auf den Cluster startet. Wenn Sie die Backup-Konfiguration anwenden, erstellt Kubernetes die Cassandra-Knoten neu. Wenn die Sicherung vor dem Neustart der Knoten startet, schlägt die erste Sicherung fehl und die nachfolgenden Sicherungen sind erfolgreich.

2. Wenden Sie die Sicherungskonfiguration auf den Speicherbereich Ihres Clusters an:

   Helm

   helm upgrade datastore apigee-datastore/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --datastore

   Dabei ist OVERRIDES_FILE der Pfad zu der Überschreibungsdatei, die Sie gerade bearbeitet haben.

3. Überprüfen Sie den Sicherungsjob. Beispiel:

   kubectl get cronjob -n apigee

   NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
   apigee-cassandra-backup   33 * * * *   False     0        <none>          94s

Manuelle Sicherung starten

Sicherungsjobs werden automatisch gemäß dem Cron-Zeitplan ausgelöst, der in der Datei overrides.yaml unter cassandra.backup.schedule festgelegt ist. Sie können einen Sicherungsjob aber auch manuell mit dem folgenden Befehl starten:

kubectl create job -n APIGEE_NAMESPACE --from=cronjob/apigee-cassandra-backup MANUAL_BACKUP_JOB_NAME

Dabei ist MANUAL_BACKUP_JOB_NAME der Name eines zu erstellenden manuellen Sicherungsjobs.

Fehlerbehebung

1. Testen Sie die Verbindung von einem Cassandra-Pod aus. Sie müssen sicherstellen, dass Ihre Cassandra-Pods über SSH eine Verbindung zu Ihrem Sicherungsserver herstellen können:
   1. Melden Sie sich in der Shell des Cassandra-Pods an. Beispiel:

      kubectl exec -it -n APIGEE_NAMESPACE APIGEE_CASSANDRA_POD -- /bin/bash

      Dabei ist APIGEE_CASSANDRA_POD der Name eines Cassandra-Pods. Ändern Sie dies in den Namen des Pods, von dem Sie eine Verbindung herstellen möchten.

   2. Stellen Sie per SSH eine Verbindung zu Ihrem Sicherungsserver her. Verwenden Sie dazu den privaten SSH-Schlüssel, der den Cassandra-Pod und die IP-Adresse des Servers bereitgestellt hat:

      ssh -i /var/secrets/keys/key apigee@BACKUP_SERVER_IP

      Hinweis: Möglicherweise wird an dieser Stelle eine Warnung angezeigt, die besagt, dass der Fingerabdruck Ihres Servers nicht erkannt wurde und Sie gefragt werden, ob Sie fortfahren möchten. Sie können an dieser Eingabeaufforderung fortfahren und die SSH-Konfiguration prüfen.
2. Wenn Sie vom Cassandra-Pod aus nicht auf Ihren Remote-Server zugreifen können, prüfen Sie noch einmal Ihre SSH-Konfiguration auf dem Remote-Server und ob das Upgrade des Datenspeichers erfolgreich war.
3. Sie können prüfen, ob Cassandra den richtigen privaten Schlüssel verwendet, indem Sie den folgenden Befehl ausführen, während Sie in Ihrem Cassandra-Pod angemeldet sind, und die Ausgabe mit dem von Ihnen erstellten privaten Schlüssel vergleichen:

   cat /var/secrets/keys/key