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:undpaths-ignore:grenzen ein, wann ein Event zählt. ${{ … }}ist ein Ausdruck. GitHub setzt ihn ein, bevor der Runner den Step sieht. Darin stehen Kontexte wiegithub,inputs,steps,needs.if:überspringt Steps oder Jobs.$GITHUB_OUTPUTreicht 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 -qbranches: [main]: Pushes auf andere Branches lösenpushnicht 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 2Erwartet (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=MoinErwartet:
https://github.com/<du>/notes-actions/actions/runs/41607798762
gh meldet die Adresse des neuen Laufs; die Zahl am Ende
ist seine ID.
workflow_dispatchstartet den Workflow nur von Hand – im Browser über „Run workflow“ oder mitgh workflow run. Er muss dafür auf dem Default-Branch liegen.-f name=wertsetzt eine Eingabe. Ohne-f stufe=…gilt der Defaultleise.${{ inputs.gruss }}steht unterenv:, nicht direkt imrun:. Warum, zeigt Tag 9 – kurz: Eingaben sind fremder Text und gehören nie direkt in ein Skript.GITHUB_SHAundGITHUB_REF_NAMEsetzt der Runner selbst als Umgebungsvariablen.${GITHUB_SHA::7}ist Bash und kürzt auf sieben Zeichen.
gh run list --workflow hallo.yml --limit 1Erwartet:
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=lautMit 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.ymlid: shagibt dem Step einen Namen. Was er alsname=wertin die Datei$GITHUB_OUTPUTschreibt, steht danach untersteps.sha.outputs.name.- Jobs laufen auf getrennten Runnern. Ein Wert wandert nur über
outputs:des Jobs undneeds:im nächsten. needs: infolegt außerdem die Reihenfolge fest:zeigenwartet aufinfo. Ohneneedslaufen Jobs parallel.$GITHUB_STEP_SUMMARYnimmt 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 --fillErwartet (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.
--fillnimmt Titel und Text aus dem Commit.- Der Push auf
version-vorgabelöst keinpushaus (nurmain), der Pull-Request aberpull_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 -qEin neuer Push auf den Branch des Pull-Requests startet den Check neu. Nach ein paar Sekunden:
gh pr checks --watchErwartet (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 -1Erwartet (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)
--squashfasst beide Commits des Branches zu einem aufmainzusammen.ghholt den neuen Stand vonmaingleich mit (Fast-forward).- Der Merge ist ein Push auf
main–ciläuft dort noch einmal.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
gh workflow listErwartet:
NAME STATE ID
ci active 405482113
hallo active 405485865
gh run list --workflow ci.yml --limit 1 --json event,conclusionErwartet (sobald der Lauf nach dem Merge fertig ist; vorher ist
conclusion leer):
[{"conclusion":"success","event":"push"}]
gh pr list --state mergedErwartet:
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 --fillNach ein paar Sekunden:
gh pr checks --watch >/dev/null
gh run list --workflow ci.yml --limit 1Mit der ID:
gh run view <ID> --log | grep 'PR pr-info'
gh pr merge --squash --delete-branchErwartet (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 aufmainpusht, regelt ein Ruleset (Tag 4). schedulenimmt 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_targethebt das auf – und ist eine der häufigsten Ursachen für kompromittierte Repositorys (Tag 9).