Zum Inhalt springen
Trainingslager IT-Trainingslager

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 -q

paths: 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.yml

Erwartet:

  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 }}"
EOF

Finde 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.yml

Erwartet:

No findings to report. Good job! (2 suppressed)
grep -c 'github.head_ref' .github/workflows/gruss.yml

Erwartet:

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 -q

Fortschritt 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/version

Erwartet:

0.7.0

Lösung

git tag v0.7.0
git push -q origin v0.7.0

release.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.yml

Sobald 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.sh
  • config.sh remove meldet den Runner bei GitHub ab – mit einem eigenen, kurzlebigen Token.
  • k3s-uninstall.sh hat 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

  1. Warum gehört ${{ github.event.issue.title }} nie direkt in ein run:?
  2. Was ist der Unterschied zwischen Cache und Artefakt?
  3. Wozu persist-credentials: false?
  4. Warum pinnt man Actions auf einen SHA, und was hält ihn aktuell?
  5. Was steht im sub eines OIDC-Tokens aus einem Job mit environment: produktion?
  6. Warum startet ein Release, das ein Workflow mit dem GITHUB_TOKEN anlegt, keinen anderen Workflow – und welche Ausnahme gibt es?
  7. Composite Action oder Reusable Workflow: Was bündelt was?
  8. Was unterscheidet einen Runner von ARC von dem aus Tag 5?

Antworten

  1. Ausdrücke werden eingesetzt, bevor die Shell den Befehl sieht. Fremder Text wird so zu Code. Über env: bleibt er Text (Tag 9).
  2. Ein Cache darf fehlen und beschleunigt nur; ein Artefakt ist ein Ergebnis, auf das sich spätere Jobs oder Menschen verlassen (Tag 3).
  3. checkout legt sonst den Token in .git/config ab, wo spätere Steps oder hochgeladene Artefakte ihn verraten können (Tag 9).
  4. Tags lassen sich verschieben, ein SHA nicht. Dependabot oder Renovate aktualisieren gepinnte SHAs anhand des Kommentars # vX.Y.Z (Tag 9, Tag 10).
  5. repo:<besitzer>@<id>/<repo>@<id>:environment:produktion (Tag 10).
  6. Schutz gegen Endlosschleifen. workflow_dispatch und repository_dispatch sind ausgenommen – darum startet release.yml das Deployment mit gh workflow run (Tag 11).
  7. Composite: mehrere Steps in einem Step. Reusable Workflow: ganze Jobs, mit eigenem runs-on und eigenen Rechten (Tag 12).
  8. 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 kubectl aus 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.