PKR-Lab

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

Was Renovate NICHT tut


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:

  1. github.com/apps/renovate öffnen.
  2. Install → Repository pkr-lab/capulus-core auswählen (nicht
    „All repositories", falls der GitHub-Account weitere private Repos hat).
  3. Renovate erkennt renovate.json automatisch 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:

  1. Fine-grained Personal Access Token erstellen, gescoped nur auf
    pkr-lab/capulus-core, mit Repository-Permissions: Contents,
    Pull requests, Issues, Workflows je auf „Read and write".
  2. Token als Repo-Secret RENOVATE_TOKEN hinterlegen
    (Settings → Secrets and variables → Actions → New repository secret).
  3. 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.