Migration von Datenbanken in Docker: So gelingt das Upgrade sicher und sauber

Datenbank-Upgrades gehören zu den Aufgaben, die man selten gern anfasst – vor allem, wenn produktive Systeme davon abhängen. Doch spätestens wenn eine Anwendung wie z.B. Authentik ein bestimmtes Datenbank-Mindestlevel verlangt (z. B. PostgreSQL ≥ 13), führt kein Weg an einer Migration vorbei.

In diesem Artikel zeige ich praxisnah, wie du eine bestehende MariaDB- oder PostgreSQL-Datenbank in einem Docker-Setup sicher auf eine neue Version migrierst.

Ob du eine produktive Authentik-Instanz migrierst oder deine Datenbank einfach sauber aktualisieren willst: Diese Anleitung führt dich Schritt für Schritt durch den Prozess.

1. 1. Alle Container ausser der Datenbank stoppen damit nichts mehr an den Daten in der Datenbank verändert wird
   2. Ein Backup der Datenbank ausführen
      1. Container ID herausfinden

         docker ps | grep "db"

      2. Dump ausführen
         1. PostgreSQL

            docker exec <container-id> pg_dumpall -U pg-user > pg-old.sql

         2. MariaDB

            docker exec <container-id> bash -c 'mysqldump -u mariadb-user -p mariadb-db' > mariadb-old.sql

      3. Wenn die Datenbank direkt auf ein im Dateisystem bestehenden Ordner schreibt muss der „neu“ angelegt werden und damit bei einem fehler wieder auf den „alten“ stand zurückgegriffen werden kann.

         mv database database.bak
         mkdir database

   3. Docker Container DB stoppen und in die Compose Datei bearbeiten
      1. Neues Image hinzufügen
      2. alle anderen Container Kommentieren mit einem # damit die aktuell noch nicht gestartet werden
      3. Stack starten

         docker compose up -d

      4. Neue Container ID herausfinden

         docker ps | grep "db"

      5. Container Log prüfen ob keine Fehler oder Warnungen aufgetaucht sind und der Container läuft

         docker logs <container-id>

      6. Dump wieder importieren
         1. PostgreSQL

            cat pg-old.sql | docker exec -i <container-id> psql -U postgres

         2. MariaDB

            cat mariadb-old.sql | docker exec -i <container-id> bash -c 'mariadb -u mariadb-user -p'

      7. Bei mir gab es nach dem Importieren Berechtigungsproblem, daher gleich nach dem importieren die Berechtigungen neu setzen
         1. PostgreSQL

            docker exec -it <container-id> psql -U pg-user
            GRANT ALL PRIVILEGES ON DATABASE pg-user TO pg-db;
            

         2. MariaDB

            docker exec -it <container-id> bash -c 'mariadb -u mariadb-user -p mariadb-db'
            GRANT ALL PRIVILEGES ON mariadb-db.* TO 'mariadb-user'@'%';

   4. Alle Container wieder normal starten
      1. Alles wieder stoppen

         docker compose down

      2. Alle Kommentierten # Container in der Compose Datei wieder auskommentieren
      3. Alles starten

         docker compose up -d

Evtl. muss je nach Umgebung der komplette Stack nochmals neugestartet werden da noch Tabellen oder Schema Updates durchgeführt wurden mit der neuen Datenbank Version.