Transparenzhinweis: In diesem Artikel geht es um mein eigenes Projekt. RunWisp ist Freie Software unter der GPL-3.0 und läuft ohne Konto. Ich entwickle es bei PoppyCake s.r.o.
Bei mir zu Hause steht ein Orange Pi 5 mit ein paar Diensten in Docker Compose: Jellyfin, Fotos, Notizen und was sich sonst so ansammelt. Jede Nacht um 4:00 sichert restic das Ganze nach Backblaze B2.
Am Morgen will ich eigentlich nur wissen: Ist das Backup gelaufen, wie lange hat es gedauert und was hat restic dazu gesagt? Mit cron ist schon das mühsam. Im Log steht, dass der Befehl gestartet wurde, und das war es. Die Ausgabe schickt cron per Mail an den lokalen Benutzer, sofern ein Mailserver installiert ist.
RunWisp
RunWisp ist ein einzelnes Go-Programm, das cron und supervisord ersetzt: Es startet geplante Jobs und hält dauerhafte Prozesse am Laufen. Alles steht in einer Datei. Meine sieht im Wesentlichen so aus:
# Alle Dienste aus der docker-compose.yml daneben
[compose.orange]
# Backup jede Nacht um 4:00
[tasks.backup]
cron = "0 4 * * *"
run = "restic backup /home/orangepi/docker && restic forget --keep-within 2d --prune"
RunWisp hebt jeden Lauf auf: wann er lief, wie lange er gedauert hat, wie er endete und was er ausgegeben hat. Am Morgen schaue ich kurz in die Weboberfläche und sehe die Ausgabe von restic so, wie sie im Terminal ausgesehen hätte. Läuft ein Job gerade, kann ich live mitlesen.
Die leere Zeile [compose.orange] ist kein Tippfehler. Sie reicht, damit RunWisp die docker-compose.yml daneben liest und jeden Dienst darin als eigenen Service führt. Die Container laufen weiter unter Docker, die YAML-Datei fasst RunWisp nicht an. Stürzt Jellyfin ab, startet RunWisp es neu, und ich sehe danach noch, was es vor dem Absturz ausgegeben hat. Hängt es nur, klicke ich auf "Restart", statt mich per SSH einzuloggen.
Wer lieber im Terminal bleibt: runwisp ohne Argumente zeigt dasselbe als Terminal-Oberfläche, auch über SSH.
Eine Regel war mir wichtig: Konfiguriert wird nur in der Datei. Die Weboberfläche kann Jobs starten und stoppen, aber nicht anlegen oder ändern. Die runwisp.toml liegt bei mir neben der docker-compose.yml und landet einfach mit im Backup. Mehr Zustand gibt es nicht.
Weg von cron
Wer schon viele Cronjobs hat, muss sie nicht abtippen. sudo runwisp takeover liest die vorhandenen crontabs, zeigt einen Plan und übernimmt sie nach einer Rückfrage. cron wird dabei nur maskiert, runwisp service uninstall stellt den alten Zustand wieder her. Für supervisord und systemd-Timer gibt es runwisp import.
Auf meinem Pi laufen übrigens immer noch zwei Cronjobs ganz klassisch. Einer davon verlängert zweimal am Tag den Entwicklermodus meines Fernsehers, damit eine selbst installierte App nicht verschwindet. Never change a running system, auch nicht für das eigene Projekt.
Und systemd-Timer?
Die Frage kommt bestimmt. systemd-Timer können vieles davon, und wer mit zwei Unit-Dateien pro Job und journalctl zufrieden ist, soll dabei bleiben. Ich wollte alle Läufe und Dienste an einer Stelle sehen und von dort steuern können, auch dort, wo es kein systemd gibt, etwa in einem Docker-Container oder auf dem Mac.
Ausprobieren
Pakete für Debian/Ubuntu und Fedora, Docker-Images und Tarballs für x86_64 und arm64 gibt es auf GitHub. Wer nur schauen will, startet runwisp demo. Das ist eine Instanz mit Beispieldaten, die beim Beenden wieder verschwindet.
Zum Schluss noch eine Frage an euch. Zählt mal nach, an wie vielen Stellen auf eurem Server etwas von selbst läuft:
crontab -l
ls /etc/cron.d /etc/cron.daily
systemctl list-timers
Schreibt die Zahl in die Kommentare, mich interessiert, wer die meisten hat.
Quellen:
RunWisp auf GitHub: https://github.com/runwisp/runwisp
Dokumentation: https://docs.runwisp.com
Docker Compose mit RunWisp: https://docs.runwisp.com/coming-from/docker-compose/
Titelbild und Screenshots: vom Autor (RunWisp mit Demo-Daten)


