f0020 - Renovate — automatische Update-PRs
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/f-cicd-automatisierung/f0020-renovate.md
Renovate — automatische Update-PRs
Renovate durchsucht das Repo nach Helm-Chart-
Versionen, Container-Image-Tags und GitHub-Actions-Versionen und öffnet
automatisch einen Pull Request, sobald eine neuere Version verfügbar ist.
Vorher musste jede neue Chart-/Image-Version manuell in values.yaml/
Chart.yaml nachgetragen werden — leicht zu übersehen, gerade bei
Sicherheitsupdates.
Was Renovate hier überwacht
| Quelle | Manager | Beispiel |
|---|---|---|
argocd/apps/*/values.yaml |
helm-values |
Image-Tags wie vaultwarden/server:1.37.1 |
argocd/apps/*/Chart.yaml |
helmv3 |
dependencies[].version (Subchart-Versionen) |
.github/workflows/*.yml |
github-actions |
uses: actions/checkout@<Commit-SHA> # vX.Y.Z (gepinnt, Preset helpers:pinGitHubActionDigests) |
.github/workflows/promote-chain.yml, tailscale-poc.yml |
customManagers (Regex) |
Tailscale-Client hinter tags: tag:ci (version: 1.104.1), nur Stable-Releases |
capulus-ansible/roles/k3s/defaults/main.yml |
customManagers (Regex) |
Helm-Release der Rolle k3s (k3s_helm_release: "v3.22.1"), nur Helm 3. Die Prüfsumme kommt bei der Installation live von get.helm.sh, ein Bump braucht keinen Hash (60020). |
Config liegt in renovate.json im Repo-Root.
Digest-Pinning: Für Docker-Images gilt pinDigests: true. Renovate hängt an jeden Tag den Digest (tag@sha256:…), die Charts setzen repository:tag zusammen, das bleibt gültig. Ausgenommen sind die selbst gebauten Images unter ghcr.io/pkr-lab/**: Deren Tag (sha-<commit>) setzen build-images.yml und bump-image-tag.py neu, ein von Renovate festgeschriebener Digest würde dabei veralten. Der erste Lauf öffnet einen größeren PR je App, der die Digests ergänzt.
Bewusst ausgenommen: **/charts/** (vendored .tgz-Subcharts, z. B.
argocd/apps/tech/headlamp/charts/headlamp-*.tgz) und Chart.lock — die werden
weiterhin manuell per helm dependency update aktualisiert, nicht per
Renovate-PR gegen eine generierte Lockdatei.
Verhalten
- Zeitplan: Minor-/Major-Updates wöchentlich (montags, ganzer Tag), Patch-
Updates sofort — damit Sicherheitspatches nicht bis Montag liegen bleiben. - Gruppierung: Alle Änderungen einer App (Chart-Version + Image-Tag)
landen in einem gemeinsamen PR statt in mehreren Einzel-PRs. - Zwei Basis-Branches:
mainundentw(baseBranches). Aufentwaktualisiert Renovate
ausschließlichargocd/apps/entw/(ENTW zuerst), aufmaindafür nichtargocd/apps/entw/: ENTW liest den
Branchentw, ein PR aufmainwäre wirkungslos. Von ENTW übernimmt die
Promotion-Kette die Versionen nach TECH/PROD. - Gemeinsame PRs für dieselbe App in TECH und PROD:
cert-manager,sealed-secretsundcloudflaredliegen
in beiden Ordnern und werden zusammen aktualisiert, damit die Cluster nicht auseinanderlaufen. - Dependency Dashboard: Renovate legt ein offenes GitHub-Issue
„Dependency Dashboard" an, das den Status aller erkannten Updates auflistet
(auch die, die z. B. wegen offener Major-Version zurückgehalten werden). - Karenzzeit:
minimumReleaseAge: 3 days. Ein neues Release wird frühestens drei Tage nach Veröffentlichung vorgeschlagen, damit kompromittierte oder zurückgezogene Versionen (typisch bei Paketen und Images) auffallen, bevor sie im Cluster landen. Das gilt auch für Patch-Updates; der Zeitplan „sofort“ oben legt nur fest, wann der PR öffnen darf, sobald die Karenzzeit um ist. Dependabot hat dieselbe Karenzzeit (cooldown: default-days: 3) für seine Versions-Updates; Sicherheits-PRs sind davon ausgenommen. - Keine Sicherheits-PRs:
vulnerabilityAlertsist abgeschaltet und bleibt es: GitHubs Advisory-Datenbank kennt Go-Module und Actions (das deckt Dependabot ab), aber keine Docker-Images und Helm-Charts, Renovate würde also nur doppelte PRs öffnen. PRs für bekannte
Sicherheitslücken öffnet Dependabot, der innerhalb von Stunden reagiert statt im
Wochenrhythmus des Fallback-Workflows
(d0080).
Umgekehrt macht Dependabot keine Versions-Updates, es gibt also keine doppelten PRs
(Ausnahme: ein Sicherheits-Update ist zugleich ein normales Patch-Update, dann einen
der beiden PRs mergen, der andere schließt sich).
Was Renovate NICHT tut
- Es merged nichts automatisch — jeder PR bleibt bis zur manuellen Prüfung
und manuellem Merge offen (Commits/Merges macht der Betreiber selbst). - Es rollt nichts im Cluster aus — erst nach dem Merge auf
maingreift der
normale GitOps-Kreislauf: ArgoCD pollt das Repo und synct die geänderte
values.yamlwie jede andere Änderung auch (siehe
capulus-core/b-kubernetes-gitops/b0010-argocd.md). - Ein Merge auf
mainlöst zusätzlich automatisch ein neues GitHub-Release
aus, siehe capulus-core/f-cicd-automatisierung/f0030-release-automation.md.
Einmalige Einrichtung (GitHub-seitig, nicht Teil dieses Repos)
Renovate läuft als GitHub App, nicht als Workflow-Datei — die Config in
renovate.json reicht nur, wenn die App installiert ist:
- github.com/apps/renovate öffnen.
- Install → Repository
pkr-lab/capulus-coreauswählen (nicht
„All repositories", falls der GitHub-Account weitere private Repos hat). - Renovate erkennt
renovate.jsonautomatisch beim nächsten Lauf und öffnet
den initialen „Configure Renovate"-PR sowie das Dependency-Dashboard-Issue.
Wichtige Falle bei Repos in einer Org: Liegt das Repo unter einer GitHub-
Org (hier pkr-lab) statt einem persönlichen Account, muss die App auf
Org-Ebene installiert/autorisiert sein
(github.com/organizations/pkr-lab/settings/installations). Eine App-
Installation, die nur für den persönlichen Account bestand, wandert bei einem
Repo-Transfer in eine Org nicht automatisch mit — Renovate verliert dann
kommentarlos den Zugriff und öffnet einfach keine PRs mehr, ohne Fehlermeldung
irgendwo im Repo selbst.
Troubleshooting
| Symptom | Hinweis |
|---|---|
| Kein PR trotz neuer Upstream-Version | Dependency-Dashboard-Issue prüfen — Update evtl. wegen Versions-Constraint zurückgehalten |
PR für charts/*.tgz oder Chart.lock erscheint doch |
packageRules-Ausschluss in renovate.json prüfen, Pfad ggf. nicht getroffen |
Renovate reagiert gar nicht mehr (kein Dependency-Dashboard-Issue, keine PRs, obwohl renovate.json valide ist) |
Meist ein App-Installations-Problem, kein Config-Problem — lokal geprüft: renovate.json ist gültiges JSON, alle fileMatch-Pfade (argocd/apps/*/values.yaml, .../Chart.yaml) existieren tatsächlich im Repo. Nächste Schritte: 1) github.com/settings/installations bzw. für Orgs github.com/organizations/pkr-lab/settings/installations öffnen und prüfen, ob die Renovate-App dort noch gelistet ist und Zugriff auf capulus-core hat. 2) Falls nicht (mehr) installiert oder Zugriff entzogen: unter „Einmalige Einrichtung" oben neu installieren. 3) Bis das geklärt ist, läuft der Fallback-Workflow unten unabhängig von der App. |
Self-hosted Fallback (GitHub Actions)
Falls die GitHub App (wieder) den Zugriff verliert, öffnet
.github/workflows/renovate.yml die
gleichen PRs unabhängig davon — über
renovatebot/github-action
mit einem PAT statt der App. Er nutzt dieselbe renovate.json, es gibt also
keine zweite Config zu pflegen.
Einmalige Einrichtung:
- Fine-grained Personal Access Token erstellen, gescoped nur auf
pkr-lab/capulus-core, mit Repository-Permissions:Contents,
Pull requests,Issues,Workflowsje auf „Read and write". - Token als Repo-Secret
RENOVATE_TOKENhinterlegen
(Settings → Secrets and variables → Actions → New repository secret). - Fertig — der Workflow startet danach montags 05:00 UTC und ist zusätzlich per
„Run workflow" manuell auslösbar.
Zeitplan (Stand 2026-10-19): 05:00 UTC entspricht 06:00 Uhr (Winter) bzw. 07:00 Uhr (Sommer) in Berlin, GitHub verzögert den Cron-Start zusätzlich (Läufe seit September zwischen 09:59 und 12:49 UTC). Der frühere Zeitplan before 6am on monday wurde dadurch nie getroffen: Renovate meldete „Skipping branch creation as not within schedule“, und seit Juni 2026 entstand in capulus-core kein Renovate-PR mehr. Der Zeitplan lautet jetzt on monday (ganzer Montag, Europe/Berlin).
Geltungsbereich: Der Fallback-Lauf bearbeitet nur capulus-core, capulus-ansible, capulus-ios und capulus-wiki-sync (RENOVATE_REPOSITORIES in renovate.yml). In den übrigen Repos hält Renovate den SHA-Pin der zentralen Workflows nicht aktuell, das geschieht von Hand (600b0).
Eigenes Image ohne Release-Zeitpunkt: Für ghcr.io/pkr-lab/capulus-wiki-sync gilt eine eigene Regel (minimumReleaseAge: null,
Zeitplan „at any time“). Das Image trägt kein Label org.opencontainers.image.created, Renovate kennt daher keinen Release-Zeitpunkt und
hielte jeden Update wegen minimumReleaseAge dauerhaft als „pending“ zurück (so blieb das Chart auf v1.0.0, obwohl v1.1.0 existiert).
Verhältnis zur App: Beide Wege schreiben denselben renovate.json-Stand
in dieselben PRs — es entsteht kein Konflikt, wenn irgendwann beide parallel
laufen. Der Workflow ist als Fallback gedacht, nicht als Ersatz: Läuft die App
wieder normal, kann RENOVATE_TOKEN einfach ungesetzt bleiben oder der
Workflow deaktiviert werden.