Einrichtung¶
Diese Seite beschreibt die einmalige Einrichtung des gemeinsamen Containers.
Sie geht von einem Server aus, auf dem Docker und Traefik bereits wie in
der Installationsanleitung laufen. Alle Befehle werden im
Arbeitsordner ausgeführt, hier /srv/docker.
Aufbau des Arbeitsordners¶
/srv/docker/
├── docker-compose.yaml
├── .env wie bisher (Traefik, ggf. Einzelinstanzen)
├── appVogelschlagmelder/ Programmcode des Vogelschlagmelders
├── appMultiTenant/ Programmcode des Oberbaus
├── multitenant/ Verwaltung der Mandanten
│ ├── hoster.env Werte für alle Gruppen (Mailserver …)
│ ├── tenants/<name>.toml Einstellungen je Gruppe
│ ├── secrets/<name>.env Zugangsdaten je Gruppe
│ ├── traefik/vsm.yml wird automatisch erzeugt
│ └── backups/ Sicherungen
└── volumes/
└── <name>/data/ Datenbank und Fotos je Gruppe
Schritt 1: Programmcode holen¶
Der Vogelschlagmelder liegt wie bisher in appVogelschlagmelder. Daneben
kommt der Oberbau:
cd /srv/docker
git clone https://codeberg.org/nabu-jena/VSM-MT.git appMultiTenant
Schritt 2: docker-compose.yaml ergänzen¶
In appMultiTenant/deploy/docker-compose.multitenant.yaml steht der
fertige Service-Block vsm-multitenant. Er wird unter services: in die
docker-compose.yaml übernommen. Die wichtigsten Teile:
vsm-multitenant:
build:
context: ./appMultiTenant
dockerfile: deploy/Dockerfile
additional_contexts:
core: ./appVogelschlagmelder/app
image: vsm-multitenant:latest
container_name: vsm-multitenant
restart: unless-stopped
env_file:
- ./multitenant/hoster.env
volumes:
- ./multitenant:/data/multitenant
- ./volumes:/data/volumes
mem_limit: 1536m
networks:
- web
Die Speichergrenze von 1,5 GB gilt für alle Gruppen zusammen. Im Lasttest blieb der Container auch bei 30 Gruppen mit gleichzeitigen Meldungen unter 1 GB.
Traefik muss außerdem eine Datei lesen, in die der Container die
Adressen aller Gruppen schreibt. Im Service traefik ergänzen:
command:
# … bisherige Einträge …
- "--providers.file.directory=/etc/traefik/dynamic"
- "--providers.file.watch=true"
volumes:
# … bisherige Einträge …
- ./multitenant/traefik:/etc/traefik/dynamic:ro
Schritt 3: Werte für alle Gruppen¶
Die Datei multitenant/hoster.env enthält, was für alle Gruppen gleich
ist – vor allem den Mailserver. Wer bestehende Installationen übernimmt,
lässt sie automatisch anlegen (siehe
Übernahme). Für einen Neuanfang:
mkdir -p multitenant/traefik
nano multitenant/hoster.env
PRODUCTION_MODE=true
UVICORN_WORKERS=2
IMAGE_WORKERS=1
SMTP_HOST=smtp.example.org
SMTP_PORT=587
SMTP_USER=alerts@example.org
SMTP_PASSWORD=geheim
SMTP_FROM=alerts@example.org
SMTP_STARTTLS=true
FROM_NAME=Vogelschlagmelder
chmod 600 multitenant/hoster.env
Variable |
Bedeutung |
|---|---|
|
Anzahl der Prozesse, die sich die Arbeit teilen. |
|
Fotos, die je Prozess gleichzeitig verarbeitet werden. Mit |
|
Mailserver für alle Gruppen, die keinen eigenen eingetragen haben |
Die übrigen Werte aus Optionale Umgebungsvariablen
– etwa POW_DIFFICULTY oder TRUSTED_PROXIES – gelten hier ebenfalls für
alle Gruppen.
Schritt 4: Bauen und starten¶
docker compose build vsm-multitenant
docker compose up -d vsm-multitenant
docker compose up -d traefik
docker compose ps vsm-multitenant
Nach etwa 20 Sekunden zeigt die letzte Zeile den Status healthy.
Schritt 5: Kurzbefehl einrichten¶
Gruppen werden mit dem Programm vsm-mt verwaltet, das im Container
läuft. Damit der Aufruf kurz bleibt, einen Alias anlegen:
echo "alias vsm-mt='docker compose -f /srv/docker/docker-compose.yaml exec -u appuser vsm-multitenant vsm-mt'" >> ~/.bashrc
source ~/.bashrc
vsm-mt tenant list
-u appuser sorgt dafür, dass alle angelegten Dateien dem Benutzer der
Anwendung gehören.
Schritt 6: Update-Skript¶
Das tägliche Update übernimmt update_restart.sh aus dem Oberbau. Es
ersetzt das bisherige Skript:
cp appMultiTenant/deploy/update_restart.sh /srv/docker/update_restart.sh
Der Cron-Eintrag bleibt, wie er ist. Was das Skript tut, steht unter Betrieb.
Weiter geht es mit Gruppen verwalten oder – wenn schon einzelne Container laufen – mit der Übernahme bestehender Installationen.