++++++++++++++++
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 <https://git.hyteck.de/moanos/ansible-playbook-static-site-host>`_.

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

.. code-block:: yaml

    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

.. warning::

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

.. hint::

  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 :file:`/static-sites`. Kernstück ist die Konfigurationsdatei :file:`docker-compose.yml`
in der die Docker-Container und der Webserver konfiguriert werden.

.. hint::

  In den meisten Fällen sollte ein Neustart der Container mit :code:`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 :file:`/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 :code:`systemctl restart mash-traefik`.