Infrastruktur-Übersicht: Sammlungen WissKI Stack¶

Produktionsnahes Docker-Compose-Deployment für eine WissKI-Sammlung (Universität Graz). Zum Vergleich mit anderen Setups: alles containerisiert, mit zwei HTTP-Einstiegspfaden (direkt TLS vs. Varnish).

Stand: Juli 2026 · Repository: /var/www/deploy/sammlungen.uni-graz.at

Architektur (Überblick)¶

flowchart TB
    subgraph Internet
        User[Browser / API-Client]
        LB[Institutioneller TLS-Terminator]
    end

    subgraph Host["Docker Host (sammlungen.uni-graz.at)"]
        subgraph MainStack["Haupt-Stack (docker-compose.yml)"]
            Varnish[Varnish :80]
            Drupal["Drupal-WissKI<br/>nginx + PHP-FPM + IIPImage<br/>:80 / :443"]
            MariaDB[(MariaDB 11.5)]
            RDF4J[(RDF4J NativeStore)]
            Solr[(Solr 9.7)]
            Redis[(Redis 7.4)]
            Adminer[Adminer :8080]
        end
    end

    User -->|HTTPS :443| Drupal
    LB -->|HTTP :80| Varnish
    Varnish --> Drupal
    Drupal --> MariaDB
    Drupal --> RDF4J
    Drupal --> Solr
    Drupal --> Redis
    Drupal -->|/adminer/| Adminer
    Adminer --> MariaDB

Container-Übersicht (7 Services)¶

Container-Namenspräfix: dockerwisski--<service>

Request-Pfade¶

1. HTTPS direkt auf Drupal (:443)¶

• TLS terminiert im Drupal-Container (nginx)
• Zertifikate: ./certificates/fullchain.pem + privkey.pem
• ACME HTTP-01: /.well-known/acme-challenge/ → ./letsencrypt-webroot

2. HTTP über Varnish (:80)¶

• Typisch hinter institutionellem TLS-Terminator / Load Balancer
• Varnish → Drupal nginx :80
• X-Forwarded-Proto: https wird gesetzt, wenn der Upstream es nicht mitsendet

3. Zusatzdienste (über Drupal-nginx)¶

Drupal / WissKI (drupal-wisski)¶

Technologie-Stack im Container¶

PHP-Ressourcen (WissKI-tuned)¶

Bootstrap / Erstinstallation (entrypoint.sh)¶

Beim ersten Start automatisch:

1. Drupal site:install (MariaDB)
2. Trusted Hosts, Private Files, Redis-Include
3. Contrib: Devel, Health Check, Redis-Modul
4. Page Cache 300 s (für Varnish)
5. Mirador, Colorbox, DomPurify Libraries
6. IIIF-Server-URL konfigurieren
7. Optional: Nextcloud WebDAV Mount
8. PHP-FPM + IIPImage starten
9. SSL-vHost aktivieren, wenn Zertifikate vorhanden

WissKI ↔ Triplestore (Env-Vars)¶

Reverse-Proxy / Varnish-Kompatibilität¶

configs/drupal/settings.local.php:

• reverse_proxy = TRUE
• Vertraute Header: X-Forwarded-For/Host/Port/Proto
• Vertraute Netze: RFC1918-CIDRs (Docker-Bridge)
• omit_vary_cookie = TRUE (bessere Varnish-Cachebarkeit)

MariaDB¶

RDF4J (Triplestore)¶

Hinweis: NativeStore = Dateisystem-basiert, kein separater GraphDB/Blazegraph. RAM ist für Query-Bursts, nicht für die Triple-Anzahl selbst.

Repository-Konfiguration (rdf4j/default_repository.ttl)¶

@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
@prefix config: <tag:rdf4j.org,2023:config/>.
[] a config:Repository ;
config:rep.id "default" ;
rdfs:label "The default repository" ;
config:rep.impl [
    config:rep.type "openrdf:SailRepository" ;
    config:sail.impl [
    config:sail.type "openrdf:NativeStore" ;
    config:native.tripleIndexes "spoc,posc" ;
    config:native.forceSync "true"
] .
].

Solr¶

Solr wird von WissKI/Drupal Search API genutzt; Core-Konfiguration erfolgt über WissKI/Drupal, nicht im Compose-File.

Redis¶

Drupal-Nutzung (drupal-wisski/config/redis/redis.settings.php)¶

Varnish¶

Cache-Logik (Kurzfassung)¶

Caching-Schichten: Varnish (Full Page) + Redis (Drupal Object Cache) + OPcache (PHP).

Persistente Volumes¶

Netzwerk¶

Alle 7 Services laufen im default-Compose-Netzwerk. Keine externen Netzwerke im Haupt-Stack.

Adminer ist nur intern erreichbar und wird über Drupal-nginx unter /adminer/ proxied.

Ressourcen-Defaults (4-GB-Profil)¶

Empfohlen für Produktion: 8 GB RAM, 4 vCPUs.

Skalierung auf 8 GB (Beispielwerte)¶

Wichtige Umgebungsvariablen (.env)¶

Vollständige Liste: example-env im Repository-Root.

Vergleichs-Merkmale (Checkliste)¶

Typische Vergleichs-Szenarien¶

Verifikation¶

# Varnish → Drupal
docker compose exec -T varnish curl -sI http://localhost/

# Redis
docker compose exec -T redis redis-cli ping

# RDF4J
docker compose exec -T rdf4j curl -s http://localhost:8080/rdf4j-server/protocol

# Solr
docker compose exec -T solr curl -s http://localhost:8983/solr/admin/info/system

# Drupal
docker compose exec -T drupal drush status

Backups¶

Persistente Daten liegen in Docker-Volumes:

• drupal-data, private_files, mariadb-data, rdf4j-data, solr-data, redis-data

docker volume inspect <volume-name>

Referenzen im Repository¶