Redirect¶

Was es tut¶

Der Redirect-Dienst stellt kurze Links unter u.garage-lab.de bereit, etwa für Aushänge oder QR-Codes vor Ort. Ein kurzer Link leitet auf eine beliebige Adresse weiter; welche Links es gibt, steht in einem Beitrag im Forum.

Wo es liegt¶

Verwaltet über¶

Forum und Repo. Die kurzen Links selbst pflegt man in einem bestimmten Beitrag im Forum; welcher das ist, steht in der Stack-Datei (DISCOURSE_TOPIC_ID). Container und Einstellungen stehen in der Stack-Datei.

Aufbau¶

flowchart LR
    forum["Forum<br>Beitrag mit den Links"]
    updater["redirect-updater"]
    vol[("redirect-updater-data<br>im Arbeitsspeicher")]
    server["redirect-server<br>Apache"]
    caddy["Caddy"]
    browser(["Browser"])

    updater -->|API| forum
    updater -->|schreibt .htaccess| vol
    server -->|liest| vol
    browser --> caddy -->|u.garage-lab.de| server

• redirect-updater liest den Beitrag im Forum über dessen API und schreibt daraus die Weiterleitungen als .htaccess für Apache. Das Image (docker.io/garagelabdus/discourse-redirect) ist eine Eigenentwicklung.
• redirect-server ist ein Apache-Webserver, der die Weiterleitungen ausliefert; seine Konfiguration steht in der Stack-Datei. Unbekannte kurze Links führen auf die Vereinswebseite.

Beide Container teilen sich das Volume redirect-updater-data, das nur im Arbeitsspeicher liegt. Beim Zugriff auf das Forum meldet sich der Updater mit einem API-Schlüssel an, der als Secret in syslet/werner/creds-redirect-updater.enc.yaml liegt.

Login / SSO¶

Keiner; der Dienst ist öffentlich und hat keine Anmeldung. Wer Links ändern darf, regelt das Forum über die Rechte am Beitrag.

Backup¶

Nichts; der Dienst hat keine eigenen Daten. Die Links stehen im Beitrag im Forum und sind mit dessen Backup gesichert; nach einem Neustart schreibt der Updater die Weiterleitungen neu.

Updates¶

Die Version des Updaters steht in image: redirect: tag: oben in der Stack-Datei (siehe Image-Version anheben).

Besonderheiten / bekannte Probleme¶

• Der Stack hat keine Locks; weil er keine Daten hat, geht beim Entfernen nichts verloren.

Entscheidungen¶

Die Links werden im Forum gepflegt, nicht im Repo. So können auch Mitglieder ohne Zugang zum Repo Links anlegen und ändern, mit den Werkzeugen, die sie aus dem Forum kennen.

Weiterlesen¶

• Discourse
• Anwendungen