Zum Inhalt springen
Trainingslager IT-Trainingslager

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

  1. Tippen, nicht kopieren. Jeder Befehl einmal selbst.
  2. Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
  3. Den Lauf lesen. gh run view, --log, --log-failed – ein roter Lauf ist eine Nachricht, kein Ärgernis.
  4. Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
  5. Challenge allein lösen. Erst den Hinweis, dann die Lösung.
  6. Lab-Werte bleiben im Lab. lab-api-key-123, lab-deploy-token-123 und die anderen lab-…-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.