Statische Seiten

Wir haben mehrere statische Websites wie diese Dokumentation. Um diese möglichst einfach & einheitlich zu erstellen und zu warten, nutzen wir dafür das Ansible-Playbook moanos/ansible-playbook-static-site-host.

Die Konfiguration für das Playbook sieht ungefähr so aus

static_sites:
  - domain: doku.queereszentrumtuebingen.de
    key: "ssh-ed25519 AAAAC3NzaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA4Z qzt-ci-static"
    user: ci-documention
    slug: static-doku
  - domain: books.queereszentrumtuebingen.de
    key: "ssh-ed25519 AAAAC3NzaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA4Z qzt-ci-static"
    user: ci-documention
    slug: static-books

Warnung

slug muss für jede Domain einen anderen Wert haben. Es wird in der automatischen Konfiguration des Webservers (Traefik) benötigt).

Hinweis

Das Playbook erstellt die angegebenen Nutzer und hinterlegt für sie den angegebenen SSH-Key. Die erstellten User können dann ausschließlich auf „ihre“ Seiten zugreifen.

Infos für Debugging

Alle vom Playbook erstellten Inhalte finden sich unter /static-sites. Kernstück ist die Konfigurationsdatei docker-compose.yml in der die Docker-Container und der Webserver konfiguriert werden.

Hinweis

In den meisten Fällen sollte ein Neustart der Container mit docker compose restart ausreichen

In Fällen in denen eine Seite nicht deployt werden kann, schau ob die SSH Keys richtig eingetragen sind, z.B. in /static_sites/ci-documention/.ssh/authorized_keys.

Wenn es Probleme mit dem Layout der Seite gibt, ist wahrscheinlich das Problem nicht durch die Serverkonfiguration ausgelöst.

Sollte es Probleme mit der SSL Verschlüsslung geben, warte ein paar Minuten und versuche einen Neustart des Reverse Proxy systemctl restart mash-traefik.