GitHub Actions-Anleitung

Geplanten GitHub Actions-Workflow überwachen

Geplante Workflows scheitern still, wenn Actions deaktiviert ist, Secrets ablaufen oder ein Schritt fehlschlägt. Ein abschließender curl-Schritt beweist, dass der Job erfolgreich endete.

Bevor Sie beginnen

Erstellen Sie einen Monitor mit der tatsächlichen Frequenz Ihres Workflows und kopieren Sie dann die URL aus dem Dashboard. Der Token ist geheim — veröffentlichen Sie ihn nicht.

Zu verwendendes Modul : workflow · curl. Platzieren Sie es nach der letzten sinnvollen Aktion auf dem Erfolgspfad.

Einrichtung

Monitor-URL in Secret kopieren

Erstellen Sie einen Monitor passend zum Zeitplan (z. B. 0 6 * * * → täglich). Im Repo: Settings → Secrets and variables → Actions → New repository secret mit Namen VERIFAGENT_URL und vollständiger Ping-URL.

https://verifagent.com/api/ping/your-ping-token

Abschließenden Heartbeat-Schritt hinzufügen

Setzen Sie curl nach den eigentlichen Arbeitsschritten, damit ein fehlgeschlagener Build nie pingt. Verwenden Sie das Secret — committen Sie den Token nie.

name: Nightly job

on:
  schedule:
    - cron: "0 6 * * *"
  workflow_dispatch:

jobs:
  run:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Run the real work
        run: ./scripts/nightly.sh

      - name: Ping Verifagent
        run: curl -fsS "${{ secrets.VERIFAGENT_URL }}"

Optional: Job bei Ping-Fehler abbrechen

curl -fsS lässt den Schritt bei Nicht-2xx-HTTP bereits scheitern. Behalten Sie ihn als letzten, damit Sie ihn nur nach erfolgreichen vorherigen Schritten erreichen.

- name: Ping Verifagent
  run: curl -fsS "${{ secrets.VERIFAGENT_URL }}"

workflow_dispatch einmal ausführen

Führen Sie den Workflow manuell im Actions-Tab aus. Der Ping-Schritt sollte 200 und {"ok":true} anzeigen. Bestätigen Sie Up in Verifagent.

{"ok":true}

Heartbeat muss der letzte Schritt auf dem Erfolgspfad sein. Passen Sie Verifagents erwartete Periode an den Schedule-Cron an; setzen Sie Kulanz über Runner-Warteschlangenverzögerung (oft 10–30 Minuten für tägliche Jobs).

Verfügbare Routen

Die Basis-URL reicht für einen Heartbeat. Varianten bereichern den Verlauf, wenn Ihre Plattform mehrere Zweige hat.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Prüfen

Nach grünem Lauf ist der Monitor Up. Deaktivieren Sie den Workflow oder lassen Sie einen frühen Schritt scheitern: kein Ping sollte ankommen und Verifagent eröffnet nach Periode + Kulanz einen Vorfall.

Erwartete Antwort: 200 {"ok":true}. Der Monitor wechselt von Pending zu Up.