Vorwort
Wenig lesen, viel tippen. Dieses Buch zeigt, wie Renovate deine
Abhängigkeiten aktuell hält, ohne dass dein Team in Pull Requests
ertrinkt. Alles läuft auf deinem Laptop: ein lokales Forgejo in Docker,
die Renovate-CLI unter Node 24 und eine kleine Demo-Anwendung
shop-api, deren Versionen absichtlich veraltet sind. Jeder
Pull Request, jedes Issue und jeder Status-Check, den du im Buch siehst,
entsteht bei dir wirklich.
Warum Forgejo und nicht GitHub? Weil du Renovate hier selbst betreibst: Du siehst jeden Lauf, jedes Log und jede Option, ohne Cloud-Konto, ohne App-Installation und ohne fremde Repositories zu stören. Was auf GitHub oder GitLab anders ist, steht jeweils in einem Hinweis und an Tag 10.
Das Buch richtet sich an Platform Engineers, DevOps- und Security-Leute, die Renovate in einer Organisation einführen oder bändigen wollen: vom ersten Onboarding-PR über Gruppen, Zeitpläne und Automerge bis zum Betrieb als CronJob mit Org-Presets und Supply-Chain-Leitplanken.
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.
- Kontrollpunkt bestehen. Erst wenn das Prüfskript nur ✔ zeigt, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab.
lab-admin-pw-123, der Bot-Token in~/renovate-lab/setup/bot-tokenund alle anderenlab-…-Werte sind Übungsdaten.
Achtung: Renovate erscheint mehrmals pro Tag in neuer Version, und die Pakete in der Demo-Anwendung bekommen ständig neue Releases. Die Zielversionen in deinen Update-PRs (zum Beispiel „Update dependency express to v4.22.3”) werden deshalb neuer sein als im Buch. Das ist kein Fehler, sondern genau das, wofür Renovate da ist.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle mit erwarteter Ausgabe |
| Kontrollpunkt | Prüfskript: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was in Produktion anders ist |
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| Gelände | 0 | Node 24, Renovate-CLI, Forgejo, Bot, Demo-Repo,
check.sh |
| A – Grundlagen | 1 | Der erste Lauf: Onboarding, Update-PRs, Dashboard |
| 2 | Konfiguration verstehen: Presets, packageRules,
Validator |
|
| 3 | Manager und Datasources: npm, Go, Docker, Helm, Kubernetes | |
| B – Steuern | 4 | Gruppieren, Planen, Begrenzen |
| 5 | Automerge und Status-Checks | |
| 6 | Versionen und Bereiche | |
| 7 | Eigene Abhängigkeiten mit customManagers |
|
| 8 | Private Registries und Zugangsdaten | |
| C – Betrieb | 9 | Self-hosted betreiben: globale Konfiguration |
| 10 | Renovate als Dienst: CronJob, GitLab CI, GitHub Actions | |
| 11 | Org-Presets | |
| 12 | Sicherheit und Supply Chain | |
| D – Praxis | 13 | Monorepos, Lockfiles und PR-Gestaltung |
| 14 | Dependency Dashboard und Fehlersuche | |
| 15 | Wettkampf: Desaster-Drills | |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Teil A zeigt, was Renovate tut und warum. Teil B macht aus dem PR-Generator ein Werkzeug, das zu deinem Team passt. Teil C bringt Renovate in den Betrieb für viele Repositories. Teil D trainiert den Alltag und den Ernstfall.
Tipp: Getestet mit Renovate 44.153.1 unter Node 24.21.0, Forgejo 16.0.6 (Image
codeberg.org/forgejo/forgejo:16.0.6-rootless), Docker 29.5, kind 0.33 (Kubernetes 1.37), kubectl 1.37 und Helm 4.3. Weicht eine Option ab: die Konfigurationsreferenz unterdocs.renovatebot.comundrenovate-config-validator.
Der Begleitcode
Alle Dateien aus diesem Buch liegen öffentlich auf GitHub: https://github.com/thomaszachmann/renovate-zum-anfassen. Wie du sie holst, zeigt Tag 0.
Los geht’s.
Thomas Zachmann, Oktober 2026