Übernahme bestehender Installationen

Laufen auf dem Server bereits mehrere Vogelschlagmelder in eigenen Containern – alle in einer gemeinsamen docker-compose.yaml mit einer .env, in der jede Instanz ein eigenes Präfix hat (BERLIN_ADMIN_USER …) –, lassen sie sich Schritt für Schritt in den gemeinsamen Container übernehmen.

Dabei gilt:

  • Die Daten bleiben, wo sie sind. Der gemeinsame Container verwendet dieselben Ordner volumes/<name>/data wie die bisherigen Container. Es wird nichts kopiert.

  • Jede Instanz wird einzeln umgestellt, das dauert jeweils weniger als eine Minute.

  • Jede Umstellung lässt sich rückgängig machen.

Voraussetzung ist die Einrichtung des gemeinsamen Containers.

Schritt 1: Alle Instanzen einlesen

Der Befehl liest die bestehende docker-compose.yaml und .env und legt für jede Instanz einen Mandanten an. Die beiden Dateien werden dafür nur lesend in einen kurzlebigen Container eingebunden:

cd /srv/docker
docker compose run --rm --no-deps --entrypoint vsm-mt -u appuser \
    -v ./docker-compose.yaml:/data/docker-compose.yaml:ro \
    -v ./.env:/data/.env:ro \
    vsm-multitenant import-compose --compose /data/docker-compose.yaml --env /data/.env
bergstrasse: übernommen (deaktiviert)
    Adresse:      https://bergstrasse.vogelschlagmelder.de
    Datenordner:  ../volumes/bergstrasse/data
…
weimar-apolda: übernommen (deaktiviert)
    Adresse:      https://weimar-apolda.vogelschlagmelder.de
    Datenordner:  ../volumes/weimar-apolda/data
    Zweitdomains: apolda.vogelschlagmelder.de, weimar.vogelschlagmelder.de

Was dabei übernommen wird:

Bisher

Danach

Service vogelschlagmelder-<name>

Mandant <name>

<PRÄFIX>_ADMIN_USER, …_PASSWORD, …_CSRF_SECRET, …_SETTINGS_SECRET

multitenant/secrets/<name>.env, unverändert

<PRÄFIX>_PUBLIC_BASE_URL, …_ALLOW_SMTP_OVERRIDE

multitenant/tenants/<name>.toml

Volume ./volumes/<name>/data

data_dir des Mandanten

Traefik-Router vogelschlagmelder-<name>-alias

aliases (Zweitdomains)

globale SMTP_…-Werte

multitenant/hoster.env

Die Instanz test wird nicht übernommen. Sie läuft weiter als eigener Container und dient zum Ausprobieren neuer Versionen. Mit --skip "" würde sie ebenfalls übernommen, mit --only berlin,koeln nur die genannten.

Alle Mandanten sind nach dem Import deaktiviert. Die bisherigen Container laufen unverändert weiter; noch hat sich für niemanden etwas geändert.

Jetzt prüfen:

vsm-mt tenant list
vsm-mt tenant check

tenant check meldet Fehler in der Konfiguration (etwa ein zu kurzes Passwort) und Auffälligkeiten in den Daten, zum Beispiel Meldungen mit einem offensichtlich falschen Datum. Solche Hinweise verhindern die Umstellung nicht, sollten aber an die Gruppe weitergegeben werden.

Schritt 2: Eine Instanz umstellen

./appMultiTenant/deploy/umstellen.sh koeln

Das Skript arbeitet in einer festen Reihenfolge, damit nie zwei Container gleichzeitig dieselbe Datenbank benutzen:

  1. Es prüft, dass koeln eingelesen und noch deaktiviert ist.

  2. Es stoppt den bisherigen Container vogelschlagmelder-koeln.

  3. Es sichert Datenbank und Fotos nach multitenant/backups/umstellung/.

  4. Es schaltet den Mandanten koeln frei (mit Prüfung).

  5. Es wartet, bis https://koeln.vogelschlagmelder.de aus dem gemeinsamen Container antwortet.

Geht in Schritt 4 oder 5 etwas schief, startet es den bisherigen Container automatisch wieder. Für die Gruppe ist die Instanz während der Umstellung etwa zehn Sekunden nicht erreichbar.

Schutz, falls ein alter Container wieder anläuft

Auch wenn ein bisheriger Container versehentlich wieder gestartet wird, schreiben nie zwei Container gleichzeitig in eine Datenbank. Das kann etwa durch docker compose up -d ohne Service-Namen oder durch das alte Update-Skript passieren. Der gemeinsame Container erkennt das innerhalb von 10 Sekunden und gibt die Instanz ab. Bis der alte Container wieder gestoppt ist, bedient dieser sie allein. Das Log meldet dann Einzelcontainer … läuft (Sperre gegen Doppelbetrieb). Auch das Freischalten (vsm-mt tenant enable) verweigert der gemeinsame Container, solange der alte Container läuft.

Deshalb gilt: Vor der ersten Umstellung das Update-Skript ersetzen (Einrichtung) und bei docker compose up -d immer den Service nennen.

Danach kurz von Hand prüfen:

  • Anmeldung im Adminbereich und in der Meldezentrale

  • eine Testmeldung mit Foto absenden – kommt die E-Mail an?

  • Foto in der Meldezentrale sichtbar?

  • Zweitdomains leiten auf die Hauptadresse um?

Empfohlene Reihenfolge

Nicht alle Instanzen auf einmal. Zuerst eine wenig genutzte Instanz einige Tage beobachten, dann in kleinen Gruppen weitermachen, zuletzt die Instanzen mit den meisten Meldungen.

Schritt 3: Aufräumen

Frühestens wenn alle umgestellten Instanzen einige Wochen ohne Auffälligkeiten laufen:

  • die Service-Blöcke der umgestellten Instanzen aus der docker-compose.yaml entfernen (test bleibt),

  • ihre präfixierten Einträge aus der .env entfernen – sie stehen jetzt in multitenant/secrets/,

  • alte Images entfernen: docker image prune.

Rückweg

Solange der bisherige Service-Block noch in der docker-compose.yaml steht:

./appMultiTenant/deploy/zurueck.sh koeln

Das Skript schaltet den Mandanten ab, wartet, bis der gemeinsame Container die Datenbank freigegeben hat, und startet den bisherigen Container. Die Daten werden direkt weiterverwendet.

Was sich an der Datenbank ändert

Im gemeinsamen Container arbeiten zwei Prozesse gleichzeitig mit jeder Datenbank. Dafür wird sie in den sogenannten WAL-Modus geschaltet; neben vogelschlagmelder.db liegen dann zeitweise die Dateien vogelschlagmelder.db-wal und -shm. Eine einzelne Installation kann eine solche Datenbank ohne Weiteres öffnen – das wurde mit Kopien aller Live-Instanzen getestet. Wichtig ist nur: Diese Dateien gehören zur Datenbank und dürfen nicht gelöscht werden.

Ist der Service-Block schon entfernt, erzeugt

vsm-mt tenant export koeln --ziel /data/multitenant/export

einen passenden Service-Block (multitenant/export/koeln.compose.yaml) und die Einträge für die .env (multitenant/export/koeln.env).