Anhang B: Abschlussprüfung
Ziel: Ohne Anleitung zeigen, dass du GitHub Actions im Alltag beherrschst: ein Workflow mit Pfadfilter, ein nächtlicher Lauf, eine Lücke schließen, ein Release von Tag bis Produktion und ein Job auf ARC. · Dauer: ca. 90 min · Voraussetzung: Tag 15
Spielregeln
- Jede Übung beschreibt nur das Ziel. Den Weg findest du selbst; die Tage in Klammern helfen beim Nachschlagen.
- Jede Übung endet mit einem Prüfblock: einzelne Befehle mit dem, was sie zeigen müssen. Erst wenn alle stimmen, gilt die Übung.
- Alles geschieht im Repository
notes-actions.
cd ~/gha-lab/notes-actionsÜbung 1: Ein Workflow nur für Doku
Leg .github/workflows/docs.yml an. Er läuft bei Pushes
auf main, die nur Markdown-Dateien
betreffen, und von Hand. Er prüft, dass README.md das Wort
notes-actions enthält, und schreibt „Doku ok“ in die
Zusammenfassung. Rechte: nur Lesen. Danach eine Änderung an der README
pushen. (Tag 2, Tag 9)
Prüfblock:
gh run list --workflow docs.yml --limit 1 --json event,conclusion --jq '.[0]'Erwartet:
{"conclusion":"success","event":"push"}
gh run list --workflow ci.yml --limit 1 --json displayTitle --jq '.[0].displayTitle'Erwartet: nicht der Titel deines README-Commits –
ci läuft bei Markdown nicht.
Lösung
cat > .github/workflows/docs.yml <<'EOF'
name: docs
on:
push:
branches: [main]
paths: ['**.md']
workflow_dispatch:
permissions:
contents: read
jobs:
pruefen:
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- run: grep -q notes-actions README.md
- run: echo "Doku ok" >> "$GITHUB_STEP_SUMMARY"
EOF
git add .github
git commit -qm "docs: README prüfen"
git push -q
echo "Übungsrepository zu GitHub Actions zum Anfassen." >> README.md
git commit -qam "README: ein Satz mehr"
git push -qpaths: ist das Gegenstück zu paths-ignore:.
Der erste Push (nur docs.yml) startet docs
nicht – er ändert keine Markdown-Datei, wohl aber ci.
Fortschritt speichern? Kostenlos registrieren
Übung 2: Ein nächtlicher Lauf
Leg .github/workflows/nacht.yml an: jede Nacht um 02:30
UTC und von Hand, Tests mit dem Race-Detector
(go test -race ./...) auf ubuntu-24.04, mit
der Composite Action von Tag 12. Starte ihn einmal von Hand. (Tag 2, Tag
12)
Prüfblock:
grep -A1 'schedule:' .github/workflows/nacht.ymlErwartet:
schedule:
- cron: '30 2 * * *'
gh run list --workflow nacht.yml --limit 1 --json event,conclusion --jq '.[0]'Erwartet:
{"conclusion":"success","event":"workflow_dispatch"}
Lösung
cat > .github/workflows/nacht.yml <<'EOF'
name: nacht
on:
schedule:
- cron: '30 2 * * *'
workflow_dispatch:
permissions:
contents: read
jobs:
race:
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: ./.github/actions/go-setup
- run: go test -race ./...
EOF
git add .github
git commit -qm "nacht: Race-Detector"
git push -q
gh workflow run nacht.yml-race braucht CGO – auf den Runnern von GitHub ist ein
C-Compiler vorhanden.
Fortschritt speichern? Kostenlos registrieren
Übung 3: Eine Lücke schließen
Ein Kollege hat diesen Workflow geschrieben:
cat > .github/workflows/gruss.yml <<'EOF'
name: gruss
on: pull_request
jobs:
gruss:
runs-on: ubuntu-24.04
steps:
- run: echo "Danke für den Branch ${{ github.head_ref }}"
EOFFinde mit zizmor alle Probleme und behebe sie, bis zizmor nichts mehr meldet. Dann committen und pushen. (Tag 9)
Prüfblock:
zizmor -q --offline .github/workflows/gruss.ymlErwartet:
No findings to report. Good job! (2 suppressed)
grep -c 'github.head_ref' .github/workflows/gruss.ymlErwartet:
1
Der Ausdruck kommt noch genau einmal vor – unter env:,
nicht im run:.
Lösung
zizmor -q --offline .github/workflows/gruss.yml | grep -E '^[a-z]+\['Erwartet:
warning[excessive-permissions]: overly broad permissions
error[template-injection]: code injection via template expansion
Ein Branch-Name wie x";curl…|sh;" wäre Code. Und ohne
permissions: gelten die Vorgaben des Repositorys:
cat > .github/workflows/gruss.yml <<'EOF'
name: gruss
on: pull_request
permissions:
contents: read
jobs:
gruss:
runs-on: ubuntu-24.04
steps:
- env:
BRANCH: ${{ github.head_ref }}
run: echo "Danke für den Branch $BRANCH"
EOF
git add .github
git commit -qm "gruss: ohne Injection"
git push -qFortschritt speichern? Kostenlos registrieren
Übung 4: Von Tag bis Produktion
Veröffentliche v0.7.0: Release mit Binärdateien, Image
0.7.0 mit Provenance, Deployment nach Produktion mit deiner
Freigabe. (Tag 7, Tag 8, Tag 10, Tag 11)
Prüfblock:
gh release view v0.7.0 --json isPrerelease,assets \
--jq '.isPrerelease, (.assets | length)'Erwartet:
false
3
gh attestation verify oci://ghcr.io/<du>/notes-api:0.7.0 -R <du>/notes-actions \
>/dev/null 2>&1; echo "Exit: $?"Erwartet:
Exit: 0
curl -s localhost:30081/versionErwartet:
0.7.0
Lösung
git tag v0.7.0
git push -q origin v0.7.0release.yml baut und veröffentlicht,
image.yml baut das Image, attestiert und signiert es, und
der Job deploy in release.yml startet
deploy.yml. Warte, bis image.yml fertig ist
(gh run list --workflow image.yml --limit 1), dann gib frei
– mit der ID aus
gh run list --workflow deploy.yml --limit 1:
gh api -X POST repos/{owner}/{repo}/actions/runs/<ID>/pending_deployments \
-F 'environment_ids[]=26123220715' -f state=approved -f comment='v0.7.0' \
--jq '.[].environment'Die Environment-ID ist deine aus Tag 10.
Fortschritt speichern? Kostenlos registrieren
Übung 5: Ein Job ohne Spuren
Ändere vm.yml so, dass der Job auf ARC läuft statt auf
gha-vm. Starte ihn zweimal und zeig, dass
~/gha-lab/laeufe.txt im Job beide Male fehlt. (Tag 5, Tag
14)
Prüfblock:
gh run view <ID> --log | grep -E 'Z (Host|Lauf)'Erwartet (für den zweiten Lauf, Namen weichen ab):
wo Wo bin ich? ... Host: arc-notes-runner-kxb5d, Benutzer: runner
wo Spuren hinterlassen ... Lauf 41636401967
Nur eine Lauf-Zeile – die Datei war
leer, als der Job begann.
Lösung
~/gha-lab gibt es im Runner-Pod nicht. Der Job legt den
Ordner selbst an:
cat > .github/workflows/vm.yml <<'EOF'
name: vm
permissions:
contents: read
on: workflow_dispatch
jobs:
wo:
runs-on: arc-notes
steps:
- name: Wo bin ich?
run: |
echo "Host: $(hostname), Benutzer: $(whoami)"
echo "Arbeitsordner: $PWD"
- name: Spuren hinterlassen
run: |
mkdir -p ~/gha-lab
echo "Lauf $GITHUB_RUN_ID" >> ~/gha-lab/laeufe.txt
cat ~/gha-lab/laeufe.txt
EOF
git commit -qam "vm: auf ARC"
git push -q
gh workflow run vm.ymlSobald der Lauf fertig ist, noch einmal
gh workflow run vm.yml.
Fortschritt speichern? Kostenlos registrieren
Aufräumen
Der Runner, k3s und ARC laufen weiter, bis du sie abbaust:
helm uninstall arc-notes -n arc-runners
helm uninstall arc -n arc-systems
cd ~/gha-lab/runner
sudo ./svc.sh stop
sudo ./svc.sh uninstall
TOKEN=$(gh api -X POST \
repos/<du>/notes-actions/actions/runners/remove-token --jq .token)
./config.sh remove --token "$TOKEN"
/usr/local/bin/k3s-uninstall.shconfig.sh removemeldet den Runner bei GitHub ab – mit einem eigenen, kurzlebigen Token.k3s-uninstall.shhat das Installationsskript angelegt; es entfernt k3s samt aller Pods und Daten.
Das Repository notes-actions und die Pakete in GHCR
bleiben. Löschen geht im Browser oder mit gh repo delete –
dafür braucht gh das Recht delete_repo
(gh auth refresh -s delete_repo).
Wissenstest
- Warum gehört
${{ github.event.issue.title }}nie direkt in einrun:? - Was ist der Unterschied zwischen Cache und Artefakt?
- Wozu
persist-credentials: false? - Warum pinnt man Actions auf einen SHA, und was hält ihn aktuell?
- Was steht im
subeines OIDC-Tokens aus einem Job mitenvironment: produktion? - Warum startet ein Release, das ein Workflow mit dem
GITHUB_TOKENanlegt, keinen anderen Workflow – und welche Ausnahme gibt es? - Composite Action oder Reusable Workflow: Was bündelt was?
- Was unterscheidet einen Runner von ARC von dem aus Tag 5?
Antworten
- Ausdrücke werden eingesetzt, bevor die Shell den Befehl sieht.
Fremder Text wird so zu Code. Über
env:bleibt er Text (Tag 9). - Ein Cache darf fehlen und beschleunigt nur; ein Artefakt ist ein Ergebnis, auf das sich spätere Jobs oder Menschen verlassen (Tag 3).
checkoutlegt sonst den Token in.git/configab, wo spätere Steps oder hochgeladene Artefakte ihn verraten können (Tag 9).- Tags lassen sich verschieben, ein SHA nicht. Dependabot oder
Renovate aktualisieren gepinnte SHAs anhand des Kommentars
# vX.Y.Z(Tag 9, Tag 10). repo:<besitzer>@<id>/<repo>@<id>:environment:produktion(Tag 10).- Schutz gegen Endlosschleifen.
workflow_dispatchundrepository_dispatchsind ausgenommen – darum startetrelease.ymldas Deployment mitgh workflow run(Tag 11). - Composite: mehrere Steps in einem Step. Reusable Workflow: ganze
Jobs, mit eigenem
runs-onund eigenen Rechten (Tag 12). - Er ist ephemer: ein Pod pro Job, danach gelöscht – keine Spuren, keine Abhängigkeit zwischen Jobs (Tag 14).
Wie geht es weiter?
- Mehr Sicherheit: actionlint und zizmor in jedem Pull-Request, Rulesets auf Organisationsebene, SHA-Pinning als Richtlinie.
- GitOps: Statt
kubectlaus dem Runner schreibt CI die Version ins Git, und Argo CD rollt aus – ohne Zugang des Runners zum Cluster. - Organisation: Zentrale Reusable Workflows, Runner-Gruppen, eine GitHub App für ARC.
Die Schwesterbücher „Sichere Lieferketten“, „Kubernetes zum Anfassen“ und „Renovate zum Anfassen“ setzen genau dort an.