Hem / Dokumentation / GitHub Actions

Push-notiser från GitHub Actions

Sluta uppdatera Actions-fliken. Lägg till ett curl-steg i valfritt arbetsflöde så pushar Pling byggresultatet direkt till din iPhone, med en tryckbar länk tillbaka till körningen. Det finns ingen Marketplace-åtgärd att lita på och inget runner-plugin att installera, bara Pling HTTP API.

Det enda steget du behöver

Lägg till din token som en repository-hemlighet med namnet PLING_TOKEN (Settings → Secrets and variables → Actions), och släpp sedan in detta steg i valfritt jobb:

      - name: Notify my phone
        run: |
          curl -sf -X POST https://api.plingpush.com/api/push \
            -H "Content-Type: application/json" \
            -d '{"token":"${{ secrets.PLING_TOKEN }}","title":"Deploy succeeded","message":"${{ github.repository }} on ${{ github.ref_name }}","channel":"ci","priority":"normal"}'

Avisera endast när något går sönder

För det mesta bryr du dig bara om röda byggen. Villkoret if: failure() kör steget endast när ett tidigare steg i jobbet misslyckades:

      - name: Push on failure
        if: failure()
        run: |
          curl -sf -X POST https://api.plingpush.com/api/push \
            -H "Content-Type: application/json" \
            -d '{"token":"${{ secrets.PLING_TOKEN }}","title":"CI failed","message":"${{ github.workflow }} on ${{ github.ref_name }}","priority":"high"}'

Rapportera varje resultat, med en länk tillbaka

Använd if: always() så att steget körs oavsett om jobbet lyckades eller misslyckades, och skicka tillbaka ${{ job.status }} plus en tryckbar url till körningen:

      - name: Push build result
        if: always()
        run: |
          curl -sf -X POST https://api.plingpush.com/api/push \
            -H "Content-Type: application/json" \
            -d "{\"token\":\"${{ secrets.PLING_TOKEN }}\",\"title\":\"CI ${{ job.status }}\",\"message\":\"${{ github.workflow }} on ${{ github.ref_name }}\",\"priority\":\"high\",\"url\":\"${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\"}"

Tryck på aviseringen på din telefon så öppnas exakt den körningen på GitHub. Gruppera dina CI-varningar med fältet channel så att de hålls åtskilda från dina andra pushar.

Where to get your token: create an API token in the Pling app, or at plingpush.com/account. The full reference, including channels and priorities, is in the API-dokument.

Vanliga frågor

Behöver jag en GitHub Marketplace-action?

Nej. Pling är en vanlig HTTP-slutpunkt, så ett enda curl-steg är allt du behöver. Det innebär ingen tredjepartsåtgärd i din leveranskedja och inget att hålla uppdaterat.

Hur aviserar jag bara när bygget misslyckas?

Lägg till if: failure() i notify-steget. GitHub kör det bara när ett tidigare steg i jobbet misslyckades, så du får en push för röda byggen och tystnad för gröna.

Kan pushen länka tillbaka till workflow-körningen?

Ja. Sätt fältet url till ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} så blir aviseringen tryckbar och öppnar körningen på GitHub.

Läcker min token ut i loggarna?

Lagra den som repository-hemligheten PLING_TOKEN. GitHub maskerar automatiskt hemligheter i loggar, och värdet visas aldrig i din arbetsflödesfil.

Fler recept: Cron-jobb · Python · fullständig API-referens