Lorixen.
DE

Wiederkehrende Aufgaben mit GitHub Actions: Zeitpläne

Kurz gesagt: Wiederkehrende Aufgaben rund um Ihre Website oder App, etwa ein nächtlicher Linkcheck, eine wöchentliche Prüfung der Sitemap oder das tägliche Erzeugen eines Produktfeeds, lassen sich mit GitHub Actions zeitgesteuert ausführen. Laut GitHub-Dokumentation starten Sie einen Workflow mit dem Ereignis schedule und einer Zeitangabe in Cron-Schreibweise. Standardmäßig gilt die Zeit in UTC, optional lässt sich eine Zeitzone wie Europe/Berlin angeben. Das kürzeste Intervall beträgt fünf Minuten. Wichtig: Geplante Läufe können zur vollen Stunde verzögert werden oder bei hoher Last ausfallen, und in öffentlichen Repositorys schaltet GitHub sie nach 60 Tagen ohne Aktivität ab.

Wofür sich geplante Workflows eignen

Wenn der Code Ihrer Website oder App ohnehin auf GitHub liegt, bieten sich geplante Workflows für viele kleine Routineaufgaben an:

  • Nächtliche Prüfung auf defekte Links.
  • Wöchentlicher Test, ob wichtige Seiten erreichbar sind und den richtigen Statuscode liefern.
  • Tägliches Erzeugen eines Produkt- oder Veranstaltungsfeeds aus einer Datenquelle.
  • Regelmäßiges Bauen und Veröffentlichen einer statischen Website, damit zeitgesteuerte Inhalte erscheinen.
  • Prüfung auf veraltete Abhängigkeiten.

Für Aufgaben, die minutengenau oder garantiert laufen müssen, etwa das Versenden von Terminerinnerungen an Kunden, ist ein eigener Zeitplaner auf dem Server oder ein Dienst mit Zusagen zur Zuverlässigkeit besser geeignet.

Der Aufbau eines geplanten Workflows

Ein Workflow ist eine YAML-Datei im Verzeichnis .github/workflows. Laut GitHub-Dokumentation verwenden Sie das Ereignis schedule mit einer Zeitangabe in POSIX-Cron-Schreibweise:

on:
  schedule:
    - cron: '30 5 * * 1-5'
      timezone: "Europe/Berlin"
  workflow_dispatch:

Die Cron-Angabe hat laut Dokumentation fünf Felder, getrennt durch Leerzeichen: Minute, Stunde, Tag des Monats, Monat und Wochentag. Das Beispiel läuft montags bis freitags um 5:30 Uhr. Ein einzelner Workflow kann laut Dokumentation mehrere Zeitpläne haben.

Der zusätzliche Eintrag workflow_dispatch erlaubt, den Workflow jederzeit von Hand zu starten. Das ist beim Testen und nach Änderungen sehr praktisch.

Zeitzonen und Sommerzeit

Laut GitHub-Dokumentation laufen geplante Workflows standardmäßig in UTC. Ohne Zeitzone läuft ein Workflow mit „0 6 * * *“ im Winter um 7 Uhr und im Sommer um 8 Uhr Ortszeit in Deutschland. Mit einer Zeitzone als IANA-Name, etwa Europe/Berlin oder Europe/Vienna, rechnet GitHub die Zeit für Sie um.

Die Dokumentation beschreibt dabei einen Sonderfall: Bei der Umstellung auf Sommerzeit werden Läufe in übersprungenen Stunden auf die nächste gültige Zeit verschoben, etwa von 2:30 auf 3:00 Uhr. Planen Sie wichtige Aufgaben deshalb nicht in die Nachtstunden, die bei der Umstellung wegfallen.

Verzögerungen einplanen

Laut GitHub-Dokumentation kann das Ereignis schedule bei hoher Auslastung verzögert werden. Zu den Zeiten mit hoher Last gehört der Beginn jeder Stunde. Ist die Last hoch genug, können laut Dokumentation einzelne Läufe in der Warteschlange sogar ganz entfallen. GitHub empfiehlt, Workflows zu einer anderen Minute innerhalb der Stunde zu planen.

Für die Praxis bedeutet das: Wählen Sie eine ungerade Minute, etwa 17 oder 43, statt 0. Und gestalten Sie Aufgaben so, dass ein ausgefallener Lauf beim nächsten Mal nachgeholt wird. Ein Feed, der immer alle aktuellen Einträge enthält, ist robuster als einer, der nur die Änderungen seit dem letzten Lauf ergänzt.

Nur auf dem Standardzweig

Laut Dokumentation laufen geplante Workflows immer auf dem letzten Stand des Standardzweigs, und die Workflow-Datei muss dort liegen. Ein Zeitplan, den Sie in einem anderen Zweig testen, startet also nicht. Verwenden Sie zum Ausprobieren workflow_dispatch und übernehmen Sie den Zeitplan erst danach in den Standardzweig.

Abschaltung nach 60 Tagen

In öffentlichen Repositorys werden geplante Workflows laut Dokumentation automatisch deaktiviert, wenn 60 Tage lang keine Aktivität im Repository stattfand. Gerade bei kleinen Projekten, an denen selten gearbeitet wird, ist das tückisch: Der Linkcheck läuft einfach nicht mehr, ohne dass jemand es merkt. Prüfen Sie den Status gelegentlich im Bereich Actions, wo deaktivierte Workflows wieder eingeschaltet werden können.

Geheimnisse und Rechte

Viele geplante Aufgaben brauchen Zugangsdaten, etwa für eine Datenquelle oder einen Server. Legen Sie diese als verschlüsselte Secrets im Repository an und niemals im Code. Geben Sie dem Workflow nur die Rechte, die er braucht, etwa nur Lesezugriff, wenn er nichts verändern muss.

Laufzeit und Kosten im Blick

Jeder Lauf verbraucht Rechenzeit. Für öffentliche Repositorys und in vielen Tarifen ist ein gewisses Kontingent enthalten, darüber hinaus fallen je nach Konto Kosten an. Prüfen Sie deshalb, wie lange ein Lauf dauert und wie oft er wirklich nötig ist. Ein Linkcheck jede Nacht reicht meist, alle fünf Minuten ist fast immer übertrieben. Setzen Sie außerdem eine Obergrenze für die Laufzeit eines Jobs, damit ein hängender Schritt nicht stundenlang Rechenzeit verbraucht, etwa wenn eine externe Seite nicht antwortet.

Ergebnisse sichtbar machen

Ein geplanter Workflow, dessen Fehler niemand sieht, ist wenig wert. GitHub zeigt fehlgeschlagene Läufe im Bereich Actions an und kann je nach Einstellung Benachrichtigungen schicken. Prüfen Sie, wer im Team diese Benachrichtigungen erhält. Für wichtige Prüfungen lohnt ein eigener Schritt, der bei einem Fehler eine Nachricht an das Team-Postfach oder einen Chat-Kanal schickt.

So richten Sie einen Workflow ein

  1. Legen Sie die Datei im Verzeichnis .github/workflows an.
  2. Definieren Sie schedule mit Cron-Angabe und Zeitzone sowie workflow_dispatch.
  3. Starten Sie den Workflow einmal von Hand und prüfen Sie das Ergebnis.
  4. Wählen Sie eine Minute abseits der vollen Stunde.
  5. Prüfen Sie nach einigen Tagen, ob die Läufe zu den erwarteten Zeiten stattfanden.
  6. Legen Sie fest, wer bei Fehlern benachrichtigt wird.

Beispiel aus der Praxis

Ein Veranstaltungsort für Konzerte in Bremen veröffentlicht sein Programm als statische Website, die aus einer Datenquelle gebaut wird. Neue Termine erschienen bisher erst, wenn jemand den Bau von Hand anstieß. Heute baut ein geplanter Workflow die Seite täglich um 6:17 Uhr Ortszeit mit der Zeitzone Europe/Berlin neu und prüft dabei alle Links. Fehler gehen an das Team-Postfach. Das Beispiel ist illustrativ.

Häufige Fragen

Wie oft kann ein Workflow laufen?

Laut GitHub-Dokumentation höchstens alle fünf Minuten.

Warum lief mein Workflow nicht pünktlich?

Geplante Läufe können bei hoher Last verzögert werden, vor allem zur vollen Stunde. Wählen Sie eine andere Minute.

Warum läuft mein Zeitplan gar nicht?

Häufige Gründe: Die Datei liegt nicht im Standardzweig, oder der Workflow wurde in einem öffentlichen Repository nach 60 Tagen ohne Aktivität deaktiviert.

Muss ich die Zeit in UTC angeben?

Nein. Laut Dokumentation können Sie eine Zeitzone wie Europe/Berlin angeben.

Wenn Sie wiederkehrende Aufgaben rund um Ihre Website automatisieren möchten, richten wir geplante Workflows gerne gemeinsam mit Ihnen ein: Automatisierung besprechen.

Quellen

WhatsAppTermin buchen