Fallstudie / Bereitstellungssystem
aktivMedia-Stack-Distribution
Ein privates Deployment-Paket, das eigene Medienautomatisierung bewahrt und gleichzeitig Geheimnisse sowie Laufzeitdaten ausserhalb von Git hält.
- Bash
- Python
- SQLite
- Docker Compose
- systemd
- SOPS
- CSS
Die Distribution ist die auslieferbare Hälfte des VPS-Wiederaufbausystems. Der Infrastruktur-Blueprint beschreibt den Host; dieses Repository bewahrt die exakten Skripte, Service-Units, die Compose-Struktur, verschlüsselte Konfiguration und Audit-Logik, die zur Reproduktion der Medienplattform nötig sind.
Trennung der Verantwortlichkeiten
- Implementierungsdateien werden versioniert und mit Prüfsummen versehen
- betriebliche Geheimnisse werden für eigene Wiederherstellungsidentitäten verschlüsselt
- Laufzeitdatenbanken und Medien gelangen nie in Git
- das Deployment beginnt mit einer Bestandsaufnahme und einem Probelauf
- die Speicheranbindung ist eine getrennte, ausdrücklich bestätigte Phase
Weshalb exakte Bewahrung wichtig ist
Kleine Wartungsskripte sammeln echtes Betriebswissen an: wie Fehler gedämpft werden, welche Artefakte in Quarantäne kommen und wie eine sichere Wiederherstellung aussieht. Diese Skripte mit ihrer Herkunft zu bewahren ist zuverlässiger, als eine spätere Sitzung ihre Funktionsweise aus einer Prosabeschreibung ableiten zu lassen.
Beziehung zur Plattform
Die Seite zur selbst gehosteten Medienplattform erklärt den sichtbaren Ablauf. Diese Fallstudie zeigt, wie dieser Ablauf rekonstruierbar wird, ohne private Konfiguration in öffentliche Dokumentation zu verwandeln.
Additive Medienbibliothek v2
Der aktuelle Repository-Stand ergänzt einen abgesicherten v2-Pfad, ohne die wiederhergestellte v1-Implementierung umzuschreiben. Er führt Folgendes ein:
- opake private Resolver-URLs in erzeugten Stream-Einträgen anstelle signierter Anbieterlinks sowie eine dauerhafte Prüfliste für mehrdeutige Medien
- eine atomare kanonische Bibliotheksansicht, die das beste abspielbare Duplikat auswählt und manueller Kuratierung nur innerhalb derselben Qualitätsstufe einen kleinen Vorrang gibt
- eine optionale, ausfallsichere Prüfung unterstützter, entfernt gespeicherter Archiv-Sätze, ohne das Archiv oder extrahierte Video dauerhaft zu speichern
- Quarantäne für fehlgeschlagene automatisierte Streams anstelle einer Neustartschleife
Für einen bereits laufenden Host beginnt das v2-Upgrade mit einem Probelauf, wird durch einen Snapshot abgesichert, ist auf freigegebene Ergänzungen beschränkt und lässt wiederkehrende Aufgaben deaktiviert, bis ausdrückliche Abnahmeprüfungen bestanden sind. Wiedergabetests für Bereichsabrufe und Fortsetzung, Katalogvalidierung, kontrollierte Wiederherstellung des Benutzerzustands und deterministisches Rollback halten die Änderung beobachtbar und reversibel.
Diese Dateien stellen eine bereitstellbare Fähigkeit im privaten Repository dar; die öffentliche Fallstudie behauptet nicht, dass der v2-Pfad bereits im Produktivbetrieb aktiviert wurde.
Reversible Jellyfin-Darstellung
Das Repository bewahrt ausserdem ein optionales Crimsonvariable-Theme für Jellyfin Web. Über Jellyfins Einstellung für Custom CSS wendet es die festgelegte Farbpalette, den Monospace-Charakter, zurückhaltende Oberflächen und das eigene Markenzeichen an. Es verbirgt weder Steuerelemente der Anwendung noch verändert es Bibliothekslayout, Wiedergabe, Serverkonfiguration oder Medienpfade.
Das Theme importiert keine Stylesheets oder Tracking-Dienste von Dritten. Wenn das Custom-CSS-Feld geleert wird, erscheint wieder die unveränderte Oberfläche. Die Begleitnotizen definieren ausserdem die Browser-, Mobil-, Barrierefreiheits-, Wiedergabesteuerungs- und Upgrade-Prüfungen, die nach einer Aktualisierung von Jellyfin Web vor der weiteren Verwendung erforderlich sind.