Zum Inhalt springen

Deployments ohne Ausfall für Node-Apps mit Docker Compose · Teil 8 von 11 der Serie

Teil 8: Der Server holt sich neue Versionen selbst

Lass den Server einmal pro Minute nach einem neuen Image schauen und das Deploy-Skript selbst ausführen, mit einem systemd-Timer. Ab jetzt genügt ein Push, und von außen kommt niemand in deinen Server.

Quest-Ziele

  • Die zwei Wege vergleichen, Pipeline und Server zu verbinden, und wissen, was jeder kostet
  • Einen systemd-Service und einen Timer für deinen eigenen Benutzer schreiben
  • Verstehen, warum nie zwei Deployments gleichzeitig laufen können
  • Das Deploy-Log mit journalctl lesen
  • Die automatischen Deployments von Hand starten, anhalten und fortsetzen

Die Pipeline baut Images, und das Skript auf dem Server tauscht Container ohne Lücke. Dazwischen wird ein Schritt noch von Hand erledigt: Jemand muss sich auf dem Server einloggen und das Skript ausführen. Dieser Teil schafft diesen Jemand ab.

Wer ruft wen?

Es gibt zwei Wege, eine Pipeline und einen Server zu verbinden.

Die Pipeline loggt sich auf dem Server ein. Nach dem Bauen des Images öffnet GitHub oder GitLab eine SSH-Verbindung zu deinem Server und führt das Skript aus. Dafür muss dort ein Schlüssel zu deinem Server hinterlegt sein. Wer an diesen Schlüssel kommt, oder an dein Konto dort, kann auf deinem Server Befehle ausführen.

Der Server fragt die Registry. Der Server schaut selbst nach, ob es ein neues Image gibt. Dafür braucht er nur das Token aus Teil 5, das Images lesen kann und sonst nichts. Niemand draußen besitzt etwas, das deinen Server öffnet.

Diese Serie nimmt den zweiten Weg. Er hat einen Preis, und der ist klein. Eine neue Version wartet bis zu einer Minute, bis der Server wieder nachschaut. Und die Pipeline kann dir nicht sagen, ob das Deployment geklappt hat, denn sie ist nicht dabei, wenn es passiert. Darum kümmert sich Teil 11 mit einer Nachricht in deinem Chat.

Ein Service und ein Timer

Auf jedem Linux-Server, den du wahrscheinlich mietest, läuft systemd: das Programm, das beim Hochfahren alles andere startet und es im Auge behält. Es kann Dinge auch nach Zeitplan ausführen, und jeder Benutzer kann ihm eigene Aufgaben geben. Das hast du schon benutzt: Rootless Docker ist so eine Aufgabe des Benutzers deploy.

Eine Aufgabe nach Zeitplan besteht aus zwei kleinen Dateien. Die erste sagt, was laufen soll. Leg auf deinem Rechner deploy/guestbook-deploy.service an:

deploy/guestbook-deploy.service
[Unit]
Description=Deploy the newest guestbook image

[Service]
Type=oneshot
Environment=DOCKER_HOST=unix://%t/docker.sock
ExecStart=%h/guestbook/deploy.sh
  • Type=oneshot beschreibt eine Aufgabe, die bis zum Ende läuft und dann fertig ist, anders als ein Programm, das bleibt, wie ein Webserver.

  • ExecStart ist der Befehl. %h steht für den Home-Ordner des Benutzers, das ist also /home/deploy/guestbook/deploy.sh.

  • Die Environment-Zeile sagt dem docker-Befehl, wo Rootless Docker lauscht. Je nachdem, wie Docker eingerichtet wurde, weiß dein Terminal das aus einer Einstellung deines Logins, die eine von systemd gestartete Aufgabe nicht liest. Mit dieser Zeile klappt es so oder so. %t ist ein Ordner, den systemd für jeden Benutzer bereithält, solange die Maschine läuft.

Die zweite Datei sagt, wann. Leg deploy/guestbook-deploy.timer an:

deploy/guestbook-deploy.timer
[Unit]
Description=Look for a new guestbook image every minute

[Timer]
OnCalendar=minutely
AccuracySec=1s

[Install]
WantedBy=timers.target
  • OnCalendar=minutely heißt: zu jeder vollen Minute. Ein Timer startet den Service mit demselben Namen, es gibt also nichts zu verbinden.

  • AccuracySec=1s verlangt Pünktlichkeit. Ohne die Zeile erlaubt sich systemd bis zu einer Minute Spielraum, um Strom zu sparen, indem es mehrere Dinge auf einmal erledigt.

  • WantedBy=timers.target lässt den Timer zusammen mit der Maschine starten, sobald du ihn aktiviert hast.

Kopier beide Dateien dorthin, wo systemd die Aufgaben eines Benutzers sucht:

~/projects/guestbook
$ ssh deploy@guestbook.example.com mkdir --parents .config/systemd/user$ scp deploy/guestbook-deploy.* deploy@guestbook.example.com:.config/systemd/user/

Schalte dann auf dem Server den Timer ein:

deploy@guestbook: ~
$ systemctl --user daemon-reload$ systemctl --user enable --now guestbook-deploy.timer$ systemctl --user list-timersNEXT                            LEFT LAST PASSED UNIT                   ACTIVATESTue 2026-11-17 10:31:00 UTC      24s -         - guestbook-deploy.timer guestbook-deploy.service1 timers listed.Pass --all to see loaded but inactive timers, too.

daemon-reload lässt systemd die neuen Dateien lesen. enable --now tut zwei Dinge: Es startet den Timer ab jetzt bei jedem Hochfahren, und es startet ihn sofort. --user in jedem Befehl heißt: die Aufgaben dieses Benutzers, nicht die des Systems, deshalb braucht nichts davon sudo. Die Liste zeigt, wann der Timer das nächste Mal läuft.

Zwei Dinge bekommst du geschenkt. systemd startet nie einen Service, der noch läuft. Dauert ein Deployment also länger als eine Minute, wartet die nächste Runde, bis es fertig ist, und zwei Deployments können sich nicht in die Quere kommen. Und der Timer läuft, obwohl niemand eingeloggt ist. Das ist das Lingering, das du in Teil 5 eingeschaltet hast: Ohne es enden die Aufgaben eines Benutzers, wenn er sich ausloggt.

Zusehen, wie es arbeitet

Was das Skript ausgibt, landet jetzt im Log des Systems, dem Journal. Verfolge es auf dem Server:

deploy@guestbook: ~
$ journalctl --user --unit guestbook-deploy.service --followNov 17 10:31:00 guestbook systemd[839]: Starting guestbook-deploy.service - Deploy the newest guestbook image...Nov 17 10:31:01 guestbook deploy.sh[4127]: 10:31:01 Nothing newNov 17 10:31:01 guestbook systemd[839]: Finished guestbook-deploy.service - Deploy the newest guestbook image.Nov 17 10:32:00 guestbook systemd[839]: Starting guestbook-deploy.service - Deploy the newest guestbook image...Nov 17 10:32:01 guestbook deploy.sh[4203]: 10:32:01 Nothing newNov 17 10:32:01 guestbook systemd[839]: Finished guestbook-deploy.service - Deploy the newest guestbook image.

Jede Minute dieselben drei Zeilen: systemd startet die Aufgabe, das Skript findet nichts Neues, die Aufgabe ist erledigt. Die Uhrzeit steht zweimal da, einmal vom Journal und einmal vom say des Skripts. Lass das Log offen und gib dem Server etwas zu finden. Ändere auf deinem Rechner in src/page.js den Platzhalter des Namensfelds von Your name zu What should we call you? und pushe, zusammen mit den zwei neuen Dateien:

~/projects/guestbook
$ git add .$ git commit --message "A friendlier placeholder"$ git push

Jetzt tu nichts. Die Pipeline braucht ein, zwei Minuten für ihre Tests und das Image. Zur nächsten vollen Minute danach kommt Bewegung ins Log auf dem Server (Caddys zwei Zeilen sind hier weggelassen):

deploy@guestbook: ~
Nov 17 10:38:00 guestbook systemd[839]: Starting guestbook-deploy.service - Deploy the newest guestbook image...Nov 17 10:38:01 guestbook deploy.sh[4689]: 10:38:01 New image found, updating the databaseNov 17 10:38:02 guestbook deploy.sh[4689]: Database is up to dateNov 17 10:38:02 guestbook deploy.sh[4689]: 10:38:02 Starting the new containerNov 17 10:38:05 guestbook deploy.sh[4689]: 10:38:05 Visitors now reach guestbook-web-3Nov 17 10:38:05 guestbook deploy.sh[4689]: 10:38:05 Version e07b6d2 is liveNov 17 10:38:05 guestbook systemd[839]: Finished guestbook-deploy.service - Deploy the newest guestbook image.

Lade das Gästebuch neu: Das Namensfeld stellt seine neue Frage, und in der Fußzeile steht e07b6d2. Du hast dich nirgends eingeloggt und nichts ausgeführt. Du hast gepusht, und das war alles. Verlass das Log mit Strg+C; der Timer macht auch ohne Publikum weiter.

Von Hand, wenn du es brauchst

Drei Befehle für die Tage, an denen dir der Zeitplan nicht passt:

deploy@guestbook: ~
$ systemctl --user start guestbook-deploy.service$ systemctl --user stop guestbook-deploy.timer$ systemctl --user start guestbook-deploy.timer

Der erste führt sofort ein Deployment aus, ohne auf die volle Minute zu warten. Auch er läuft über systemd, kann also nicht mit einer Runde des Timers zusammenstoßen. Der zweite hält die automatischen Deployments an, zum Beispiel während du auf dem Server arbeitest, und der dritte setzt sie fort.

Was du jetzt hast

Die Pipeline ist komplett. Du pushst auf main, die Tests laufen, das Image wird gebaut, der Server holt es innerhalb einer Minute und tauscht die Container ohne Lücke. Das Einzige, was GitHub oder GitLab mit deinem Server tun können, ist, ihm ein Image anzubieten.

Bisher war jede Version eine gute. Im nächsten Teil geht es um die andere Sorte: eine Version, die nicht richtig startet, und eine, die läuft, aber nie hätte live gehen dürfen.

Kommentare

Die Kommentare sind GitHub Discussions: Zum Schreiben mit GitHub anmelden.

Die Kommentare kommen über giscus von GitHub. Beim Laden gehen deine IP-Adresse an giscus.app und GitHub.