Backups auf Ihrer Appliance konfigurieren

Informationen zu GitHub Enterprise Server Backup-Dienstprogramme

GitHub Enterprise Server Backup-Dienstprogramme ist ein Backup-System, das Sie auf einem separaten Host installieren, der in regelmäßigen Intervallen über eine sichere SSH-Netzwerkverbindung Backup-Snapshots von Ihre GitHub Enterprise Server-Instanz erstellt. Mit einem Snapshot können Sie eine vorhandene GitHub Enterprise Server-Instanz in einem vorherigen Zustand auf dem Backup-Host wiederherstellen.

Nur die seit dem letzten Snapshot hinzugefügten Daten werden über das Netzwerk übertragen und belegen zusätzlichen physischen Speicherplatz. Zum Minimieren der Auswirkung auf die Leistung werden Backups online unter der niedrigsten CPU-/E/A-Priorität durchgeführt. Zum Durchführen eines Backups muss kein Wartungsfenster geplant werden.

Ausführlichere Informationen zu Features, Anforderungen und zur erweiterten Nutzung finden Sie in der GitHub Enterprise Server Backup-Dienstprogramme README.

Voraussetzungen

Sie müssen über ein von Ihre GitHub Enterprise Server-Instanz getrenntes Linux- oder Unix-Hostsystem verfügen, um GitHub Enterprise Server Backup-Dienstprogramme verwenden zu können.

Sie können GitHub Enterprise Server Backup-Dienstprogramme auch zur langfristigen dauerhaften Speicherung von kritischen Daten in eine vorhandene Umgebung integrieren.

Es wird empfohlen, dass der Backup-Host und Ihre GitHub Enterprise Server-Instanz geografisch voneinander getrennt sind. Dadurch wird gewährleistet, dass Backups wiederhergestellt werden können, falls am Hauptstandort eine schwere Katastrophe oder ein Netzwerkausfall auftritt.

Die Anforderungen an den physischen Speicher variieren basierend auf der Git-Repository-Festplattennutzung und den erwarteten Wachstumsmustern:

Entsprechend Ihrer Nutzung, beispielsweise in Bezug auf die Benutzeraktivität und die ausgewählten Integrationen, sind möglicherweise mehr Ressourcen erforderlich.

GitHub Enterprise Server Backup-Dienstprogramme installieren

1. Laden Sie die neueste GitHub Enterprise Server Backup-Dienstprogramme-Version herunter, und extrahieren Sie die Datei mit dem Befehl tar.

   $ tar -xzvf /path/to/github-backup-utils-vMAJOR.MINOR.PATCH.tar.gz     

2. Kopieren Sie die enthaltene Datei backup.config-example nach backup.config, und öffnen Sie sie in einem Editor.
3. Legen Sie den Wert GHE_HOSTNAME auf den Hostnamen oder die IP-Adresse Ihrer primären GitHub Enterprise Server-Instanz fest.
4. Legen Sie den Wert GHE_DATA_DIR auf den Dateisystempfad fest, unter dem Sie Backup-Snapshots speichern möchten.
5. Öffnen Sie unter https://HOSTNAME/setup/settings die Seite mit den Einstellungen Ihrer primären Instanz, und fügen Sie der Liste der autorisierten SSH-Schlüssel den SSH-Schlüssel des Backup-Hosts hinzu. Weitere Informationen finden Sie unter „Auf die Verwaltungsshell (SSH) zugreifen“.
6. Führen Sie den Befehl ghe-host-check aus, um die SSH-Konnektivität mit Ihre GitHub Enterprise Server-Instanz zu verifizieren.

   $ bin/ghe-host-check        

7. Führen Sie den Befehl ghe-backup aus, um ein anfängliches vollständiges Backup zu erstellen.

   $ bin/ghe-backup        

Weitere Informationen zur erweiterten Nutzung finden Sie in der GitHub Enterprise Server Backup-Dienstprogramme-Datei 'README.md'.

Backup planen

Mithilfe des Befehls cron(8) oder eines ähnlichen Diensts zum Planen von Befehlen können Sie regelmäßige Backups auf dem Backup-Host planen. Die konfigurierte Backup-Häufigkeit schreibt das Worst Case Recovery Point Objective (RPO) in Ihrem Wiederherstellungsplan vor. Angenommen, Sie haben das Backup so geplant, dass es täglich um Mitternacht ausgeführt wird. In diesem Fall könnten Sie in einem Notfallszenario bis zu 24 Stunden an Daten verlieren. Es wird empfohlen, mit einem stündlichen Backup-Plan zu beginnen. Dadurch wird garantiert, dass schlimmstenfalls maximal eine Stunde an Daten am Hauptstandort vernichtet wird.

Wenn sich Backup-Versuche überschneiden, wird der Befehl ghe-backup mit einer Fehlermeldung abgebrochen. Diese gibt an, dass ein gleichzeitiges Backup vorhanden ist. In diesem Fall wird empfohlen, die Häufigkeit Ihrer geplanten Backups zu verringern. Weitere Informationen finden Sie im Abschnitt „Backups planen“ der GitHub Enterprise Server Backup-Dienstprogramme README.

Backup wiederherstellen

Im Falle eines längeren Ausfalls oder einer Katastrophe am Hauptstandort können Sie Ihre GitHub Enterprise Server-Instanz wiederherstellen. Stellen Sie dazu eine andere GitHub Enterprise-Appliance bereit, und führen Sie auf dem Backup-Host eine Wiederherstellung aus. Sie müssen der Ziel-GitHub Enterprise-Appliance den SSH-Schlüssel des Backup-Hosts als einen autorisierten SSH-Schlüssel hinzufügen, bevor Sie eine Appliance wiederherstellen.

Führen Sie den Befehl ghe-restore aus, um den letzten erfolgreichen Ihre GitHub Enterprise Server-Instanz-Snapshot wiederherzustellen. Es sollte in etwa folgende Ausgabe angezeigt werden:

$ ghe-restore -c 169.154.1.1
  > Checking for leaked keys in the backup snapshot that is being restored ...
  > * No leaked keys found
  > Connect 169.154.1.1:122 OK (v2.9.0)

  > WARNING: All data on GitHub Enterprise appliance 169.154.1.1 (v2.9.0)
  >          will be overwritten with data from snapshot 20170329T150710.
  > Please verify that this is the correct restore host before continuing.
  > Type 'yes' to continue: yes

  > Starting restore of 169.154.1.1:122 from snapshot 20170329T150710
  # ...output truncated
  > Completed restore of 169.154.1.1:122 from snapshot 20170329T150710
  > Visit https://169.154.1.1/setup/settings to review appliance configuration.

Sie können diese zusätzlichen Optionen mit dem Befehl ghe-restore verwenden:

• Das Flag -c überschreibt die Einstellungen, Zertifikate und Lizenzdaten auf dem Ziel-Host, selbst wenn es bereits konfiguriert ist. Lassen Sie dieses Flag weg, wenn Sie eine Testinstanz für Testzwecke einrichten und Sie die vorhandene Konfiguration auf dem Ziel beibehalten möchten. Weitere Informationen finden Sie unter „Backup- und Wiederherstellungsbefehle verwenden“ der GitHub Enterprise Server Backup-Dienstprogramme README.
• Mit dem Flag -s können Sie einen anderen Backup-Snapshot auswählen.