GitHub Actions

Lass einen fertigen Workflow dein Handy zum Vibrieren bringen.

Pocket Alert schickt GitHub-Actions-Ergebnisse als Push-Benachrichtigungen auf dein Handy. Füg einen curl-Schritt zu einem Workflow hinzu, und wenn ein Build, Deployment oder Release fertig ist, kommt das Ergebnis in unter einer Sekunde auf dem iPhone oder Android an – ohne dass du den Actions-Tab im Blick behalten musst.

Push in <1 Sek.Schlüssel als SecretEin curl-SchrittAktualisiert am
Funktionen

Vom Workflow-Lauf auf den Sperrbildschirm

Dein Workflow weiß bereits, wann ein Job fertig ist. Pocket Alert macht diesen Moment zu einer Push-Benachrichtigung, die du nicht übersehen kannst.

Ein Schritt in deinem Workflow

Ein einziger curl-Aufruf gegen die Messages-API macht aus jedem Workflow-Schritt eine Push-Benachrichtigung. Kein Runner-Setup, kein zusätzlicher Dienst.

Schlüssel als Repo-Secret

Lies deinen API-Schlüssel aus ${{ secrets.POCKETALERT_API_KEY }}, damit er nicht in Logs auftaucht und du ihn im Dashboard rotieren kannst.

Benachrichtigungen nach den Ergebnissen, die du wählst

Kombiniere if: failure() und if: success(), um fehlgeschlagene Builds und grüne Deployments als getrennte, klar beschriftete Nachrichten zu senden.

Ein Kanal pro Repo

Jede Anwendung hat eine eigene ID, daher bleiben Läufe pro Repo und pro Umgebung in getrennten Kanälen.

Zustellung in unter einer Sekunde

Der Schritt feuert in dem Moment, in dem der Job endet, sodass das Ergebnis in weniger als einer Sekunde auf deinem Handy ankommt.

Vollständiger Lauf-Kontext

Übernimm github.repository, github.sha und github.workflow in die Nachricht, damit du genau weißt, um welchen Lauf es ging.

Los geht's

Drei Schritte zu GitHub-Actions-Benachrichtigungen auf deinem Handy

1

Anwendung anlegen

Lege in Pocket Alert eine Anwendung an und speichere deinen API-Schlüssel als Repo-Secret POCKETALERT_API_KEY.

2

Schritt einrichten

Füg einen Benachrichtigungs-Schritt hinzu, der per curl die Messages-API aufruft und mit if: failure() und if: success() die Ergebnisse auswählt.

3

Zuordnen und loslegen

Übernimm Repo, SHA und Workflow in die Nachricht. Der nächste Lauf lässt dein Handy vibrieren.

GitHub-Actions-Benachrichtigungen aufs Handy schicken

1. Anwendung anlegen und API-Schlüssel speichern

Lege in Pocket Alert eine Anwendung an und kopiere deinen API-Schlüssel. Speichere ihn als Repository-Secret mit dem Namen POCKETALERT_API_KEY unter Einstellungen → Geheimnisse und Variablen → Actions.

2. Benachrichtigungs-Schritt hinzufügen, der die Messages-API aufruft

- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'

3. An eine bestimmte Anwendung senden

Füg application_id zum Body hinzu, um die Push-Benachrichtigung an eine App zu senden (die TID findest du im Dashboard):

-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'

In der Dokumentation zum Einstieg findest du alle Felder, die die Messages-API akzeptiert.

FAQ

Fragen und Antworten

Füg einen Schritt hinzu, der curl gegen https://api.pocketalert.app/v1/messages ausführt, und übergib deinen API-Schlüssel im Token-Header. Setz ihn ans Ende des Jobs, damit ein abgeschlossenes Deployment oder ein fehlgeschlagener Build direkt eine Push-Benachrichtigung auf dein Handy schickt.

Speichere deinen API-Schlüssel als Repository-Secret und lies ihn mit ${{ secrets.POCKETALERT_API_KEY }} aus, der im Token-Header gesendet wird. Der Schlüssel taucht nie in Logs auf, und du rotierst ihn im Pocket-Alert-Dashboard.

Verwende if: failure() und if: success() in zwei getrennten Schritten. Ein fehlgeschlagener Build löst eine Nachricht aus, ein grünes Deployment eine andere, sodass du nur die Ergebnisse verdrahtest, die dich interessieren.

Gib jedem Repo oder jeder Umgebung eine eigene Anwendung. Frontend-, Backend- und Release-Workflows landen in getrennten Kanälen, die du unabhängig stummschalten kannst.

Verwende Run-Kontext wie ${{ github.repository }}, ${{ github.sha }} und ${{ github.workflow }} im Nachrichtentext, damit die Push-Benachrichtigung genau sagt, welcher Lauf abgeschlossen wurde.

Der Schritt ruft https://api.pocketalert.app/v1/messages mit einem Token-Header und einem JSON-Body aus title und message auf. Füg application_id hinzu, um die Push-Benachrichtigung an eine bestimmte App zu leiten.

Füg "level":"high" zum Body des Fehler-Schritts hinzu, dann durchbricht die Push-Benachrichtigung auf dem iPhone den Fokus und klingelt auf Android deutlich hörbar; "level":"critical" geht noch weiter und umgeht „Nicht stören“ komplett. Meldungen über grüne Deployments kannst du als "level":"silent" senden, dann landen sie im Verlauf, ohne zu vibrieren.

Weißt du, dass das Deployment grün ist, ohne den Lauf zu beobachten.

Lege eine Anwendung an, hol dir deinen API-Schlüssel und füg den Pocket-Alert-Schritt in deinen Workflow ein.