Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 2: Trigger und Ausdrücke

Ziel: Festlegen, wann ein Workflow läuft – Push auf bestimmte Branches, Pull-Requests, Start per Knopfdruck mit Eingaben – und mit Ausdrücken, Bedingungen und Outputs Daten zwischen Steps und Jobs weitergeben. · Dauer: ca. 75 min · Voraussetzung: Tag 1

Briefing

  • on: kennt Dutzende Events. Die wichtigsten: push, pull_request, workflow_dispatch (von Hand), schedule (Zeitplan).
  • Filter wie branches: und paths-ignore: grenzen ein, wann ein Event zählt.
  • ${{ … }} ist ein Ausdruck. GitHub setzt ihn ein, bevor der Runner den Step sieht. Darin stehen Kontexte wie github, inputs, steps, needs.
  • if: überspringt Steps oder Jobs. $GITHUB_OUTPUT reicht Werte an spätere Steps, outputs: an spätere Jobs weiter.
 push main ──┐
 pull_request ┼─► on: ─► jobs.info ──outputs──► jobs.zeigen (needs: info)
 dispatch ───┘           steps ── $GITHUB_OUTPUT ──► steps.<id>.outputs.<name>

Drill 1: Trigger eingrenzen

Bisher startet jeder Push den Workflow, auch eine Änderung an einer README. Neue ci.yml:

cd ~/gha-lab/notes-actions
cat > .github/workflows/ci.yml <<'EOF'
name: ci
on:
  push:
    branches: [main]
    paths-ignore: ['**.md']
  pull_request:

jobs:
  test:
    runs-on: ubuntu-24.04
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-go@v7
        with:
          go-version-file: go.mod
      - name: Statische Prüfung
        run: go vet ./...
      - run: go test ./...
EOF
git commit -qam "ci: nur main und Pull-Requests"
git push -q
  • branches: [main]: Pushes auf andere Branches lösen push nicht mehr aus. Für sie gibt es den Pull-Request.
  • paths-ignore: ['**.md']: Ändert ein Push nur Markdown-Dateien, läuft nichts.
  • pull_request: ohne Filter: jeder Pull-Request, egal auf welchen Branch.

Jetzt nur eine README:

echo "# notes-actions" > README.md
git add README.md
git commit -qm "README"
git push -q
gh run list --limit 2

Erwartet (nach ein paar Sekunden, IDs weichen ab):

STATUS  TITLE                         WORKFLOW  BRANCH  EVENT  ID           ELAPSED  AGE
✓       ci: nur main und Pull-Requ... ci        main    push   41607670136  24s      1m
✓       ci: go vet                    ci        main    push   41607356701  19s      3m

Der Commit „README“ steht nicht in der Liste – kein Lauf.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Start per Knopfdruck mit Eingaben

Ein zweiter Workflow zum Ausprobieren:

cat > .github/workflows/hallo.yml <<'EOF'
name: hallo
on:
  workflow_dispatch:
    inputs:
      gruss:
        description: Womit begrüßen?
        default: Hallo
      stufe:
        type: choice
        options: [leise, laut]
        default: leise

jobs:
  info:
    runs-on: ubuntu-24.04
    steps:
      - name: Begrüßen
        env:
          GRUSS: ${{ inputs.gruss }}
          WER: ${{ github.actor }}
        run: echo "$GRUSS, $WER! Commit ${GITHUB_SHA::7} auf $GITHUB_REF_NAME"
EOF
git add .github
git commit -qm "hallo: Workflow zum Ausprobieren"
git push -q
gh workflow run hallo.yml -f gruss=Moin

Erwartet:

https://github.com/<du>/notes-actions/actions/runs/41607798762

gh meldet die Adresse des neuen Laufs; die Zahl am Ende ist seine ID.

  • workflow_dispatch startet den Workflow nur von Hand – im Browser über „Run workflow“ oder mit gh workflow run. Er muss dafür auf dem Default-Branch liegen.
  • -f name=wert setzt eine Eingabe. Ohne -f stufe=… gilt der Default leise.
  • ${{ inputs.gruss }} steht unter env:, nicht direkt im run:. Warum, zeigt Tag 9 – kurz: Eingaben sind fremder Text und gehören nie direkt in ein Skript.
  • GITHUB_SHA und GITHUB_REF_NAME setzt der Runner selbst als Umgebungsvariablen. ${GITHUB_SHA::7} ist Bash und kürzt auf sieben Zeichen.
gh run list --workflow hallo.yml --limit 1

Erwartet:

STATUS  TITLE  WORKFLOW  BRANCH  EVENT              ID           ELAPSED  AGE
*       hallo  hallo     main    workflow_dispatch  41607798762  1s       now

Warte, bis der Lauf fertig ist (gh run watch <ID>), dann:

gh run view <ID> --log | grep 'Moin,'

Erwartet (Zeitstempel gekürzt, Commit weicht ab):

info    Begrüßen    2026-11-03T09:02:38Z Moin, <du>! Commit 5fa343e auf main

Fortschritt speichern? Kostenlos registrieren

Drill 3: Bedingungen

cat > .github/workflows/hallo.yml <<'EOF'
name: hallo
on:
  workflow_dispatch:
    inputs:
      gruss:
        description: Womit begrüßen?
        default: Hallo
      stufe:
        type: choice
        options: [leise, laut]
        default: leise

jobs:
  info:
    runs-on: ubuntu-24.04
    steps:
      - name: Begrüßen
        env:
          GRUSS: ${{ inputs.gruss }}
          WER: ${{ github.actor }}
        run: echo "$GRUSS, $WER! Commit ${GITHUB_SHA::7} auf $GITHUB_REF_NAME"
      - name: Laut
        if: inputs.stufe == 'laut'
        run: echo "DAS WAR LAUT"
      - name: Nur bei Fehler
        if: failure()
        run: echo "Ein Step davor ist gescheitert"
EOF
git commit -qam "hallo: Bedingungen"
git push -q
gh workflow run hallo.yml -f stufe=laut

Mit der ID aus gh run list --workflow hallo.yml --limit 1, sobald der Lauf fertig ist:

gh run view <ID> -v | grep -E 'Laut|Fehler'

Erwartet:

  ✓ Laut
  - Nur bei Fehler
  • In if: darf ${{ }} fehlen – GitHub liest den Wert ohnehin als Ausdruck.
  • Ohne Angabe gilt if: success(): Ein Step läuft nur, wenn alle davor grün waren. failure() dreht das um, always() läuft immer.
  • - heißt übersprungen. Starte zum Vergleich ohne -f stufe=laut: Dann steht auch bei „Laut“ ein -.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Outputs zwischen Steps und Jobs

cat > .github/workflows/hallo.yml <<'EOF'
name: hallo
on:
  workflow_dispatch:
    inputs:
      gruss:
        description: Womit begrüßen?
        default: Hallo

jobs:
  info:
    runs-on: ubuntu-24.04
    outputs:
      kurz: ${{ steps.sha.outputs.kurz }}
    steps:
      - name: Kurzen Commit ermitteln
        id: sha
        run: echo "kurz=${GITHUB_SHA::7}" >> "$GITHUB_OUTPUT"
      - name: Im selben Job lesen
        env:
          KURZ: ${{ steps.sha.outputs.kurz }}
        run: echo "Step-Output $KURZ"

  zeigen:
    needs: info
    runs-on: ubuntu-24.04
    steps:
      - name: Im nächsten Job lesen
        env:
          KURZ: ${{ needs.info.outputs.kurz }}
        run: |
          echo "Job-Output $KURZ"
          echo "### Gebaut aus $KURZ" >> "$GITHUB_STEP_SUMMARY"
EOF
git commit -qam "hallo: Outputs"
git push -q
gh workflow run hallo.yml
  • id: sha gibt dem Step einen Namen. Was er als name=wert in die Datei $GITHUB_OUTPUT schreibt, steht danach unter steps.sha.outputs.name.
  • Jobs laufen auf getrennten Runnern. Ein Wert wandert nur über outputs: des Jobs und needs: im nächsten.
  • needs: info legt außerdem die Reihenfolge fest: zeigen wartet auf info. Ohne needs laufen Jobs parallel.
  • $GITHUB_STEP_SUMMARY nimmt Markdown auf, das GitHub auf der Seite des Laufs zeigt.

Mit der neuen ID, sobald der Lauf fertig ist:

gh run view <ID> --log | grep -E 'Output [0-9a-f]{7}'

--log enthält auch die Befehlszeilen selbst (echo "Step-Output $KURZ"). Das Muster Output gefolgt von sieben Hex-Zeichen trifft nur die Ausgaben. Erwartet (Commit weicht ab):

info    Im selben Job lesen 2026-11-03T09:07:06Z Step-Output 053f22b
zeigen  Im nächsten Job lesen   2026-11-03T09:07:11Z Job-Output 053f22b

Fortschritt speichern? Kostenlos registrieren

Drill 5: Ein Pull-Request

Die Vorgabe für die Version soll 0.5.0-dev werden – auf einem eigenen Branch:

git switch -c version-vorgabe
sed -i 's/"dev"/"0.5.0-dev"/' main.go
git commit -qam "version: 0.5.0-dev als Vorgabe"
git push -q -u origin version-vorgabe
gh pr create --fill

Erwartet (gekürzt):

...
Creating pull request for version-vorgabe into main in <du>/notes-actions

https://github.com/<du>/notes-actions/pull/1

Die Zeilen mit remote: davor stammen vom Push: GitHub schlägt dort selbst vor, einen Pull-Request anzulegen.

  • --fill nimmt Titel und Text aus dem Commit.
  • Der Push auf version-vorgabe löst kein push aus (nur main), der Pull-Request aber pull_request.

Warte ein paar Sekunden, bis GitHub den Check angelegt hat:

gh pr checks --watch

--watch frischt die Tabelle auf, bis alle Checks fertig sind. Erwartet (am Ende):

Some checks were not successful
0 cancelled, 1 failing, 0 successful, 0 skipped, and 0 pending checks

   NAME                    DESCRIPTION  ELAPSED  URL
X  ci/test (pull_request)               17s      https://github.com/<du>/notes-...

Rot. Warum? Die ID steht in gh run list --limit 1:

gh run view <ID> --log-failed | grep -E 'FAIL|version='

Erwartet (Spalten davor gekürzt):

... --- FAIL: TestMetrics (0.00s)
...     main_test.go:97: fehlt: notes_build_info{store="memory",version="dev"} 1
...         notes_build_info{store="memory",version="0.5.0-dev"} 1
... FAIL
... FAIL    example.com/notes-api   0.147s
... FAIL

Der Test erwartet die alte Vorgabe. Genau dafür ist der Check im Pull-Request da: Der Fehler fällt auf, bevor er auf main landet. Den Test anpassen und nachschieben:

sed -i 's/version="dev"/version="0.5.0-dev"/' main_test.go
git commit -qam "test: Version 0.5.0-dev"
git push -q

Ein neuer Push auf den Branch des Pull-Requests startet den Check neu. Nach ein paar Sekunden:

gh pr checks --watch

Erwartet (am Ende):

All checks were successful
0 cancelled, 0 failing, 1 successful, 0 skipped, and 0 pending checks

   NAME                    DESCRIPTION  ELAPSED  URL
✓  ci/test (pull_request)               18s      https://github.com/<du>/notes-...

Zusammenführen und aufräumen:

gh pr merge --squash --delete-branch
git log --oneline -1

Erwartet (gekürzt):

✓ Squashed and merged pull request <du>/notes-actions#1 (version: 0.5.0-dev als Vorgabe)
...
Fast-forward
 main.go      | 2 +-
 main_test.go | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
✓ Deleted local branch version-vorgabe and switched to branch main
✓ Deleted remote branch version-vorgabe
363ae6a (HEAD -> main, origin/main) version: 0.5.0-dev als Vorgabe (#1)
  • --squash fasst beide Commits des Branches zu einem auf main zusammen.
  • gh holt den neuen Stand von main gleich mit (Fast-forward).
  • Der Merge ist ein Push auf main – ci läuft dort noch einmal.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

gh workflow list

Erwartet:

NAME   STATE   ID
ci     active  405482113
hallo  active  405485865
gh run list --workflow ci.yml --limit 1 --json event,conclusion

Erwartet (sobald der Lauf nach dem Merge fertig ist; vorher ist conclusion leer):

[{"conclusion":"success","event":"push"}]
gh pr list --state merged

Erwartet:

Showing 1 of 1 pull request in <du>/notes-actions that match your search

ID  TITLE                           BRANCH           CREATED AT
#1  version: 0.5.0-dev als Vorgabe  version-vorgabe  about 1 minute ago

Challenge

Ergänze ci.yml um einen Step, der nur bei Pull-Requests läuft und in die Zusammenfassung schreibt, von welchem Branch in welchen gemergt werden soll. Prüfe es mit einem zweiten Pull-Request.

Hinweis: github.event_name, github.head_ref und github.base_ref.

Lösung

cat > .github/workflows/ci.yml <<'EOF'
name: ci
on:
  push:
    branches: [main]
    paths-ignore: ['**.md']
  pull_request:

jobs:
  test:
    runs-on: ubuntu-24.04
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-go@v7
        with:
          go-version-file: go.mod
      - name: Statische Prüfung
        run: go vet ./...
      - run: go test ./...
      - name: PR-Info
        if: github.event_name == 'pull_request'
        env:
          VON: ${{ github.head_ref }}
          NACH: ${{ github.base_ref }}
        run: echo "PR $VON -> $NACH" | tee -a "$GITHUB_STEP_SUMMARY"
EOF
git switch -c pr-info
git commit -qam "ci: PR-Info"
git push -q -u origin pr-info
gh pr create --fill

Nach ein paar Sekunden:

gh pr checks --watch >/dev/null
gh run list --workflow ci.yml --limit 1

Mit der ID:

gh run view <ID> --log | grep 'PR pr-info'
gh pr merge --squash --delete-branch

Erwartet (gekürzt):

test    PR-Info 2026-11-03T09:10:00Z PR pr-info -> main
✓ Squashed and merged pull request <du>/notes-actions#2 (ci: PR-Info)
...
✓ Deleted remote branch pr-info

tee -a schreibt die Zeile ins Log und hängt sie an die Zusammenfassung.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Branches schützen, nicht nur filtern: branches: [main] steuert nur, wann der Workflow läuft. Dass niemand direkt auf main pusht, regelt ein Ruleset (Tag 4).
  • schedule nimmt Cron-Ausdrücke in UTC, z. B. cron: '17 3 * * 1' für montags 03:17. Läufe starten nur vom Default-Branch, können sich zu vollen Stunden verzögern, und in inaktiven öffentlichen Repositorys schaltet GitHub sie nach 60 Tagen ab.
  • Pull-Requests aus Forks bekommen keine Secrets und ein Token nur mit Leserechten. pull_request_target hebt das auf – und ist eine der häufigsten Ursachen für kompromittierte Repositorys (Tag 9).