BrillianzeHomelab
Vergleich
BsN-Ochsenkopf in Schwarz-Rot-Gold mit goldenem C

GitLab als eigene Entwicklungsplattform

Wer GitLab selbst betreibt, verwaltet nicht nur Git-Repositories. Die offizielle Backup-Dokumentation nennt im Sicherungsarchiv auch Datenbankdaten, Konten und Gruppen, CI/CD-Artefakte und Jobprotokolle, LFS-Objekte, Wikis und weitere projektbezogene Dateien. Das ist für die Planung entscheidend: Ein Repository lässt sich zwar klonen, aber ein Klon enthält nicht die gesamte Arbeitsumgebung. Wenn ein Team Probleme, Berechtigungen und Pipeline-Ergebnisse an GitLab bindet, muss der Wiederherstellungsplan diese Zustände mitdenken. Die Grenze zwischen „Quellcode ist vorhanden“ und „Plattform funktioniert wieder“ ist erheblich. [1]

Was das Archiv tatsächlich abdeckt

GitLab stellt eine Kommandozeilenschnittstelle für Backups der Instanz bereit. Die Dokumentation beschreibt als Standard ein komprimiertes Tar-Archiv mit zahlreichen GitLab-Daten. Sie nennt jedoch ebenso ausdrücklich Ausnahmen: Konfigurationsdateien unter /etc/gitlab, TLS- und SSH-Schlüssel, Redis-Daten mit Sidekiq-Jobs sowie je nach Installationsart Objektspeicher gehören nicht einfach automatisch dazu. Gerade die Konfiguration und Geheimnisse werden benötigt, damit eine neue Instanz dieselben Integrationen und verschlüsselten Werte nutzen kann. Eine Kopie des Tar-Archivs allein ist daher keine vollständige Notfallakte. [1]

Ordne vor dem ersten Backup jedem Speicherbereich einen Besitzer zu: Wer sichert das GitLab-Archiv, wer die Konfiguration und wer externe Objekte? Protokolliere außerdem, ob Uploads und Registries im lokalen Dateisystem oder anderswo liegen. Es reicht nicht, die Zielplatte des Archivjobs zu prüfen, wenn die eigentlichen Nutzdaten in einem externen Speicher stehen. Dieser Gedanke gilt ebenfalls für den Artikel über Datenbank-Backups: Unterschiedliche Datenpfade verlangen zusammenpassende Sicherungsstände, nicht nur einzelne grüne Jobs.

Der Restore hat eine Versionsbindung

Die Wiederherstellungsdokumentation verlangt eine bereits funktionierende Zielinstallation. Außerdem kann ein Backup nur in exakt dieselbe GitLab-Version und denselben Typ – Community Edition oder Enterprise Edition – zurückgespielt werden, mit dem es erstellt wurde. Ein „wir installieren später einfach die neueste Version“ ist damit kein belastbarer Plan. Wenn du ein Archiv langfristig aufbewahrst, notiere auch den passenden Installationsstand und die Installationsart. Für eine zuverlässige Probe empfiehlt GitLab eine frische Instanz mit der passenden Version; gleichnamige vorhandene Repositories können andernfalls den Restore scheitern lassen. [2]

Der Restore prüft laut Dokumentation vor dem Entpacken freien Platz im Backup-Verzeichnis und verlangt dabei mindestens das Dreifache der Archivgröße. Diese Prüfung ist eine Abschätzung und garantiert nicht, dass der Platz in allen Fällen ausreicht. Plane also nicht allein anhand des komprimierten Archivs. Eine isolierte Wiederherstellung zeigt zusätzlich, ob Konfiguration und Schlüssel vorhanden sind und ob GitLab die erwarteten Projekte samt Berechtigungen wirklich anzeigen kann. [2]

Ein konkreter Abnahmetest

Erstelle ein unkritisches Projekt mit einem Commit, einem Testzugang und einer kleinen Pipeline-Ausgabe. Halte vor der Sicherung die Instanzversion und den Speicherort der zusätzlichen Konfiguration fest. Stelle das Archiv auf einer separaten, gleich versionierten Instanz wieder her; kontrolliere Login, Repository-Verlauf, Artefakt und einen neuen Klon. Prüfe anschließend, ob externe Objekte und die für Integrationen nötigen Schlüssel übernommen wurden. Führe diese Probe nicht auf der einzigen produktiven Instanz durch. Halte alle Abweichungen im Testprotokoll fest, damit beim nächsten Sicherungslauf klar ist, welcher Teil des Verfahrens angepasst werden muss. Für die allgemeine Trennung von Kopien, Aufbewahrung und Testumgebung hilft die Backup-Strategie für Selfhoster.

GitLab lohnt sich dort, wo ein Team diese integrierte Arbeitsumgebung benötigt und ihren Betrieb tragen kann. Die Kehrseite ist die größere Zahl zusammengehöriger Zustände. Ein vollständiger Nachweis ist daher nicht das Archiv allein, sondern der dokumentierte Restore inklusive Konfiguration, Zugängen und einer funktionierenden Projektprobe.

Secrets und externe Objekte getrennt nachweisen

Im Restore-Protokoll sollte neben dem GitLab-Archiv eine Inventarliste der Konfiguration und der eingesetzten Objektspeicher stehen. Prüfe nach dem Rückspielen nicht nur den Git-Verlauf, sondern einen Upload oder ein CI-Artefakt aus jedem tatsächlich verwendeten Speicherweg. Fehlende Schlüssel können verschlüsselte Werte unbrauchbar machen, obwohl Repositories angezeigt werden. Solche Schlüssel dürfen im Testprotokoll nur als vorhanden oder fehlend erscheinen, nie als Klartext. [1]

Offizielle Quellen