Ü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>/datawie 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 |
Mandant |
|
|
|
|
Volume |
|
Traefik-Router |
|
globale |
|
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:
Es prüft, dass
koelneingelesen und noch deaktiviert ist.Es stoppt den bisherigen Container
vogelschlagmelder-koeln.Es sichert Datenbank und Fotos nach
multitenant/backups/umstellung/.Es schaltet den Mandanten
koelnfrei (mit Prüfung).Es wartet, bis
https://koeln.vogelschlagmelder.deaus 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.yamlentfernen (testbleibt),ihre präfixierten Einträge aus der
.enventfernen – sie stehen jetzt inmultitenant/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).