Installation

docker-compose.yml

Ein ausführlicheres Beispiel als im Schnellstart. Nicht alle Optionen werden in jedem Fall benötigt; auskommentierte Zeilen sind optional.

services:
    gws:
        image: gbdconsult/gws-amd64:8.5
        container_name: gws
#       restart: unless-stopped
        ports:
            - "80:80"
#           - "443:443"
        volumes:
            - /var/gws/data:/data:ro
            - /var/gws-var:/gws-var
#           - /etc/letsencrypt/live/example.com:/data/ssl:ro
        tmpfs:
            - /tmp
        environment:
#           - GWS_CONFIG=/data/config.cx
#           - PGSERVICEFILE=/data/pg_service.conf
#           - GWS_LOG_LEVEL=INFO

    qgis:
        image: gbdconsult/gbd-qgis-server-amd64:3.44
        container_name: qgis
        volumes:
            - /var/gws/data:/data:ro
            - /var/gws-var:/gws-var
        tmpfs:
            - /tmp

Images & Versionen

Die Images liegen unter https://hub.docker.com/u/gbdconsult, jeweils für amd64 und arm64. Sie benötigen das WebSuite-Image (gbdconsult/gws-<arch>) und – für QGIS-Funktionen – das QGIS-Server-Image (gbdconsult/gbd-qgis-server-<arch>).

Ein Tag wie 8.4 zeigt stets auf den aktuellsten 8.4.x-Stand. Releases sind nicht immer kompatibel; beim Wechsel auf eine neue Version (z. B. 8.4 → 8.5) sind meist Anpassungen an der Konfiguration nötig.

Volumes & Mounts

Im Beispiel werden Host-Verzeichnisse in die Container eingebunden. Bei Host-Mounts sind die Dateiberechtigungen relevant; ggf. müssen Sie uid/gid des Container-Users setzen (Default 1000/1000, siehe GWS_UID/GWS_GID).

• /data – Konfiguration und Daten (.qgs, GeoTIFF …). Weder WebSuite noch QGIS müssen hierhin schreiben; meist genügt :ro. Für große Rasterbestände empfiehlt sich ein eigenes Mount (z. B. /data/raster).
• /gws-var – Cache und Datenaustausch zwischen den Containern. Beide Container müssen hierhin schreiben können.
• tmpfs /tmp – temporäres Verzeichnis im Arbeitsspeicher.

Ports

Die WebSuite antwortet auf 80/http und 443/https. Ist HTTPS über hinterlegte Zertifikate aktiv, wird ein permanenter Redirect von http auf https gesetzt.

Umgebungsvariablen

Umgebungsvariablen überschreiben stets den entsprechenden Eintrag in der Konfiguration.

Für den QGIS-Container gelten zusätzlich die QGIS-Server-Variablen, u. a. QGIS_WORKERS (paralleles Rendern) und PGSERVICEFILE.

Proxy und eigene CA-Zertifikate

In Netzen, deren Proxy TLS-Verbindungen aufbricht und mit einem eigenen Zertifikat neu signiert, schlagen ausgehende HTTPS-Anfragen der WebSuite (WMS, WMTS, Tiles, LDAP) fehl, solange der Container die CA des Proxys nicht kennt. Die WebSuite prüft Zertifikate gegen die Zertifikatsliste des Systems im Image.

Zusätzliche CA-Zertifikate geben Sie als eine PEM-Datei in GWS_EXTRA_CA_BUNDLE an. Beim Start hängt die WebSuite sie an die Systemliste an, schreibt das Ergebnis nach <GWS_VAR_DIR>/config/ca-bundle.crt und verwendet diese Datei für alle Verbindungen:

gws:
        volumes:
            - /etc/ssl/proxy-ca.pem:/data/proxy-ca.pem:ro
        environment:
            - GWS_EXTRA_CA_BUNDLE=/data/proxy-ca.pem
            - HTTPS_PROXY=http://proxy.example.com:3128
            - HTTP_PROXY=http://proxy.example.com:3128
            - NO_PROXY=localhost,127.0.0.1,qgis,db.example.com

Ist die CA auf dem Host bereits installiert, können Sie stattdessen die Zertifikatsliste des Hosts über die des Images legen: /etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/ca-certificates.crt:ro.

Beachten Sie dabei:

• Tragen Sie in NO_PROXY alle internen Hosts ein, vor allem den QGIS-Container. Sonst gehen auch Anfragen an QGIS Server über den Proxy.
• Der QGIS-Container lädt entfernte Daten selbst. Er braucht eigene Proxy-Variablen und die CA, etwa über die eingehängte Zertifikatsliste des Hosts.
• Die Liste aus GWS_EXTRA_CA_BUNDLE gilt für Prozesse, die über den Befehl gws laufen, also für den Server und docker exec ... gws .... Ein Skript, das Sie direkt mit docker exec ... python3 starten, sieht sie nicht.
• Python lehnt CA-Zertifikate ohne die Erweiterung keyUsage ab. Ein älteres Proxy-Zertifikat ohne diese Erweiterung muss neu ausgestellt werden.

Wichtige Konfigurationsthemen

Nicht alles ist über Umgebungsvariablen steuerbar. Die folgenden Einstellungen setzen Sie in der Konfiguration:

• Webserver & Rewrites – die Webseite web.site. Die Rewrite-Regeln für Start- und Projektseite bringt sie von sich aus mit; eigene Regeln brauchen Sie nur für zusätzliche Adressen. Ein minimales Beispiel zeigt das Einfache Projekt.
• SSL – Zertifikat und Schlüssel hinterlegen:

web.ssl {
    crt "/data/ssl/example.com.crt"
    key "/data/ssl/example.com.key"
}

• QGIS-Server – Erreichbarkeit des qgis-Containers:

server.qgis.host "qgis"
server.qgis.port 80

Weitere Optionen: gws.server.core.QgisConfig.

• PostgreSQL/PostGIS – Datenbank-Provider in der Konfiguration hinterlegen:

database.providers+ {
    type postgres
    uid "mydb"
    host "db.example.com"
    port 5432
    username "bob"
    password "*****"
}

Der Einsatz von pg_service.conf wird empfohlen.

• Locale – für korrekte Beschriftungen, Zahlen- und Datumsformate:

locales ["de_DE"]

• Server-Einstellungen – Worker/Threads, Timeouts, Logging und das automatische Neuladen der Konfiguration in gws.server.core.Config.

Container steuern

Starten und Stoppen über docker compose:

docker compose up -d      # starten
docker ps                 # Status
docker compose down       # stoppen

Befehle direkt an die Applikation senden Sie mit docker exec; eine Übersicht bietet die Kommandozeilen-Referenz:

docker exec gws gws -h