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

UVICORN_WORKERS

Anzahl der Prozesse, die sich die Arbeit teilen. 2 ist der empfohlene Wert: Fällt einer aus, arbeitet der andere weiter

IMAGE_WORKERS

Fotos, die je Prozess gleichzeitig verarbeitet werden. Mit 1 sind es im ganzen Container zwei Fotos zur selben Zeit

SMTP_…, FROM_…

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.