Vorwort
Wenig lesen, viel tippen. Jeder Push testet den Code, jedes Tag baut ein Release, jedes Image ist signiert, und nach Produktion geht nur, was ein Mensch freigegeben hat – das ist CI/CD, wie es sein soll. Bei vielen Teams steht dazwischen eine YAML-Datei, die keiner mehr ganz versteht.
Dieses Buch macht dich sicher mit GitHub Actions. Du lernst Workflows, Jobs und Steps, Trigger und Ausdrücke, Matrix, Cache und Artefakte. Dann baust du Container mit Buildx, schiebst sie in die GitHub Container Registry und veröffentlichst Releases. Du sicherst die Lieferkette ab – Trivy, SBOM, Provenance, cosign – und die Workflows selbst: Rechte, Pinning, Injection, OIDC, Environments. Am Ende stehen eigene Runner auf deiner VM und in Kubernetes, wiederverwendbare Workflows und eine eigene Action.
Der rote Faden ist notes-api, eine kleine Notiz-API
in Go. Sie zieht in dein eigenes Repository notes-actions,
wird getestet, gelintet, gebaut, gescannt, signiert, veröffentlicht und
schließlich auf ein k3s auf deiner VM ausgerollt.
Das Buch richtet sich an Entwickler, Admins und Platform-Leute, die Git, Docker und die Kommandozeile kennen und ihre Pipelines verstehen wollen statt sie zu kopieren.
Die Trainingsregeln
- Tippen, nicht kopieren. Jeder Befehl einmal selbst.
- Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
- Den Lauf lesen.
gh run view,--log,--log-failed– ein roter Lauf ist eine Nachricht, kein Ärgernis. - Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab.
lab-api-key-123,lab-deploy-token-123und die anderenlab-…-Werte sind Übungsdaten. Dein Repository ist öffentlich – echte Geheimnisse haben darin nichts zu suchen.
Achtung: Alle Ausgaben stammen aus echten Testläufen. Zeiten, IDs, Commits und Run-Nummern werden bei dir abweichen. Entscheidend ist, was passiert.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle und Workflows mit erwarteter Ausgabe |
| Kontrollpunkt | Einzelne Prüfbefehle: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was in Organisationen anders ist |
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| 1 – Grundlagen | 0 | Das Trainingsgelände |
| 1 | Der erste Workflow | |
| 2 | Trigger und Ausdrücke | |
| 3 | Bauen, Matrix, Cache, Artefakte | |
| 4 | Lint und Rulesets | |
| 2 – Container und Releases | 5 | Ein eigener Runner |
| 6 | Images bauen und nach GHCR pushen | |
| 7 | Releases | |
| 8 | SBOM, Scan, Signatur, Provenance | |
| 3 – Sicherheit und Deployment | 9 | Workflows absichern |
| 10 | Environments, OIDC und Updates | |
| 11 | Deployment auf Kubernetes | |
| 4 – Wiederverwendung | 12 | Composite Actions und Reusable Workflows |
| 13 | Eine eigene JavaScript-Action | |
| 14 | Runner auf Kubernetes mit ARC | |
| Wettkampf | 15 | Acht kaputte Workflows |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Das Labor
Du brauchst ein GitHub-Konto. Gearbeitet wird auf einer
Ubuntu-26.04-VM gha mit 2–4 CPUs und 4–8 GB RAM, die du per
Multipass startest, per SSH. Jede andere Linux-VM mit sudo
und Internetzugang tut es auch. Die Jobs laufen auf den kostenlosen
Runnern von GitHub, ab Tag 5 auch auf deiner VM, ab Tag 14 in einem k3s
darauf.
Die getesteten Versionen: GitHub CLI 2.103, Runner 2.338, Docker 29.9, Go 1.27, golangci-lint 2.15, k3s 1.37, Helm 4.3, ARC 0.15.1, zizmor 1.32, cosign 3.1. Die Actions: checkout v7, setup-go v7, upload-artifact v7, download-artifact v8, golangci-lint-action v9, setup-buildx v4, login v4, metadata v6, build-push v7, trivy-action 0.36, sbom-action 0.24, attest v4, cosign-installer v4.
Den Begleitcode findest du unter
https://github.com/thomaszachmann/github-actions-zum-anfassen;
Tag 0 holt ihn per git clone. Er enthält notes-api – die
Workflows schreibst du selbst.
Wo dieses Buch einen Bereich nur anreißt, gehen die Schwesterbücher in die Tiefe: „Dockerfiles zum Anfassen“ für den Dockerfile von notes-api, „Sichere Lieferketten“ für SBOM und Signaturen, „Kubernetes zum Anfassen“ für den Cluster, „Renovate zum Anfassen“ für Updates im großen Stil.
Los geht’s.