Zum Inhalt springen
Beta

PostgreSQL zu STACKIT PostgreSQL Flex mit pgcopydb migrieren

Zuletzt aktualisiert am

Verwenden Sie dieses Beispiel, um die Datenbanken eines selbstverwalteten PostgreSQL-Servers, beispielsweise in einem Rechenzentrum vor Ort, in STACKIT PostgreSQL Flex zu verschieben. Es verwendet pgcopydb, um während eines Schreibstopps eine konsistente Kopie zu erstellen. Ein Verifizierungsschritt zeigt anschließend, ob Quelle und Ziel identisch sind, bevor Sie die Entscheidung über den Cutover treffen.

Das Repository baut den kompletten Weg als Demo auf, einschließlich eines Stellvertreters für das Kundendatenzentrum mit einer Enterprise-Firewall vor der Datenbank. Terraform baut nur die Infrastruktur. Die Migration selbst ist eine Abfolge von Skripten, die Sie bewusst ausführen, da sie einen Schreibstopp enthält und mit einer Cutover-Entscheidung endet. Passen Sie die Skripte an Ihre Quellumgebung an, bevor Sie sie für eine echte Migration verwenden.

Architektur des Beispiels: Ein Quell-STACKIT-Projekt simuliert das Rechenzentrum vor Ort mit einer VM hinter einer Security Group mit Standard-Verweigerung, auf der PostgreSQL 18 und ein pgcopydb-Runner in Podman laufen; der Runner kopiert über TCP 5432 mit verifiziertem TLS über die öffentliche IP der VM zu einer PostgreSQL-Flex-18-Instanz in einem Zielprojekt, dessen ACL nur diese IP zulässt

Zwei Gates befinden sich auf dem Weg, eines pro Seite, wie bei einer echten Migration:

  • Quellseite, die Enterprise-Firewall. Sie verweigert standardmäßig allen Traffic. Die Migrationsphase fügt die eine benötigte Regel hinzu: Egress zu PostgreSQL Flex auf TCP-Port 5432. In einer echten Umgebung ist dies die Änderungsanfrage an das Firewall-Team.
  • Zielseite, die PostgreSQL-Flex-ACL. Sie lässt nur die öffentliche Adresse der Quelle zu.

pgcopydb läuft auf einem Migrationshost neben der Quelldatenbank. Es liest die Quelle lokal, streamt die Daten mit parallelem COPY in PostgreSQL Flex und erstellt anschließend Indizes und Constraints auf dem Ziel. Es wird nichts auf der Festplatte zwischengespeichert.

PostgreSQL Flex kann derzeit keine ausgehenden Verbindungen öffnen, daher ist eine native logische Replikation, bei der sich das Ziel bei der Quelle abonniert, nicht möglich. Eine kontinuierliche Synchronisation mit pgcopydb clone --follow benötigt Berechtigungen für Replikationsursprungs-Funktionen, die PostgreSQL Flex derzeit nicht erteilt. Einfaches pgcopydb clone funktioniert mit den Standardrollen. Der Preis ist ein Schreibstopp für die Dauer der Kopie, daher sollten Sie die Kopierzeit mit einem repräsentativen Datenvolumen üben.

Die Hauptversion des Ziels muss mindestens der Hauptversion der Quelle entsprechen. Das Runner-Image wird mit den Client-Tools der Zielversion erstellt, und der Preflight-Schritt prüft dies.

Führen Sie die Skripte auf dem Migrationshost einmal pro Datenbank aus:

Der Fingerabdruck vergleicht Objekte, exakte Zeilenzahlen, Sequenzwerte, Constraints, Trigger, Funktionen und Berechtigungen. Er zählt Zeilen, vergleicht aber nicht deren Inhalt. Für eine vollständige Inhaltsprüfung führen Sie 60-verify.sh <db> --compare-data aus, das jede Tabelle auf beiden Seiten liest. Planen Sie diese Zeit innerhalb des Schreibstopps ein (kostet mehr Zeit und verwendet das Standard-pgcopydb --compare-data)

Die PostgreSQL-Flex- und Migrationsphasen hängen nicht von der Demo-VM ab. Für ein echtes Datenzentrum überspringen Sie 01-source, setzen Sie die Quell-Egress-Adressen und die Datenbankliste für PostgreSQL Flex und führen Sie den Runner auf einem Linux-Host neben der Datenbank mit Podman oder Docker aus. Verwenden Sie einen schreibgeschützten Migrationsbenutzer und verifiziertes TLS zur Quelle und fordern Sie die Firewall-Öffnung zu den PostgreSQL-Flex-Adressen an.

Falls bereits ein Kubernetes-Cluster neben der Quelldatenbank läuft, kann pgcopydb auch dort ausgeführt werden, beispielsweise mit einem Kubernetes-Operator.

Code & Registry github.com Beispiel für die Migration von PostgreSQL zu PostgreSQL Flex Repository öffnen STACKIT Dokumentation docs.stackit.cloud Dokumentation zu STACKIT PostgreSQL Flex Dokumentation öffnen Code & Registry github.com pgcopydb Repository öffnen