Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang A: Spickzettel

Stand des Buchs: Renovate-CLI 44.153.1 unter Node 24 LTS (24.21.0), Forgejo 16.0.6 (rootless, SQLite) in Docker. Namen entsprechen dem Lab: Org shop, Repos shop-api, shop-worker, shop-deploy, shop-mono, Preset-Repo shop/renovate-config.

Lab-Umgebung

source ~/renovate-lab/setup/env.sh          # PATH, FORGEJO, ADMIN, RENOVATE_*
~/renovate-lab/setup/check.sh               # Gelände prüfen (✔/✘)
~/renovate-lab/setup/up.sh                  # Forgejo starten, User + Bot-Token
~/renovate-lab/setup/seed.sh --reset        # shop/shop-api frisch (Stand Tag 0)
~/renovate-lab/setup/mkrepo.sh shop/shop-worker ~/renovate-lab/code/tag03/shop-worker
export RENOVATE_GITHUB_COM_TOKEN=$(gh auth token)   # optional, nie in Dateien
# Neubau mit frischer Datenbank (der Token gehört zur alten DB!)
docker rm -f forgejo && docker volume rm forgejo-data forgejo-conf
rm ~/renovate-lab/setup/bot-token && ~/renovate-lab/setup/up.sh
Was Wert im Lab
Forgejo Web / API http://127.0.0.1:3000 / http://127.0.0.1:3000/api/v1
Container, Image forgejo, codeberg.org/forgejo/forgejo:16.0.6-rootless
Admin (Lab-Wert) lab-admin / lab-admin-pw-123, in env.sh als $ADMIN
Bot (Lab-Wert) renovate-bot, Token in ~/renovate-lab/setup/bot-token
Bot-Scopes write:repository,write:issue,read:user,read:organization,read:package
Renovate npm install --prefix ~/renovate-lab/tools [email protected]
Node ^24.11.0 laut engines; Node 25+ endet mit Exit 1

Renovate aufrufen

renovate shop/shop-api                         # echter Lauf (Env aus env.sh)
renovate --dry-run=extract shop/shop-api       # nur Dateien lesen
renovate --dry-run=lookup shop/shop-api        # + Registries fragen
renovate --dry-run=full shop/shop-api          # + Branches lokal bauen
renovate --dry-run=lookup --onboarding=false --require-config=optional shop/shop-api
renovate --platform=local                      # aktuelles Verzeichnis, schreibt nie
renovate --print-config=true --platform=local --dry-run=extract
renovate --dry-run=extract --report-type=file --report-path=report.json \
  shop/shop-api shop/shop-worker               # JSON-Report für jq
renovate --pr-hourly-limit=0 shop/shop-tools   # Option für einen Lauf überstimmen
renovate --autodiscover --autodiscover-filter='shop/*' \
  --write-discovered-repos=repos.json          # Repo-Liste schreiben, sonst nichts
renovate --autodiscover=false lager/lager-app  # autodiscover aus config.js aus
renovate --checked-branches=renovate/prettier-3.x shop/shop-api   # wie Häkchen
LOG_LEVEL=debug LOG_FORMAT=json renovate shop/shop-api > lauf.json 2>&1
Modus Registries Branches lokal schreibt in Forgejo
extract nein nein nein
lookup ja nein nein
full ja ja (inkl. Lockfile, kein PR) nein
--platform=local ja (Default lookup) nie nie
  • --print-config frisst sonst das nächste Argument: immer --print-config=true.
  • --platform=local liest nur Dateien, die Git kennt: neue Dateien vorher git add.
  • Listen auf der Kommandozeile trennt Renovate am Komma: shop/{a,b} nur in config.js (Tag 9).

Validator

renovate-config-validator                         # Repo-Config im aktuellen Verz.
renovate-config-validator --strict                # nötige Migration = Fehler (CI!)
renovate-config-validator --no-global renovate.json   # Datei als Repo-Config
renovate-config-validator config.js               # mit Dateiname: globale Config
renovate-config-validator --no-global *.json platform/*.json   # Preset-Repo
Befund Exit Beispiel
unbekannte Option 1 Invalid configuration option: prHourlyLimt
veraltete Option 0, mit --strict 1 matchPackagePatterns, fileMatch, prTitle
Global-Option im Repo 1 The "requireConfig" option is a global option
Tippfehler im Preset 0 config:recomended – erst ein Lauf meldet ihn

Umgebungsvariablen

Jede Option geht als RENOVATE_<OPTION> (prHourlyLimit → RENOVATE_PR_HOURLY_LIMIT). Rangfolge: config.js < RENOVATE_* < CLI-Flag (Tag 9).

Variable Wirkung
RENOVATE_PLATFORM, RENOVATE_ENDPOINT forgejo, http://127.0.0.1:3000/api/v1
RENOVATE_TOKEN Bot-Token, ohne Zeilenumbruch
RENOVATE_GITHUB_COM_TOKEN github.com-Lookups und Release Notes
RENOVATE_CONFIG_FILE anderer Pfad als ./config.js
RENOVATE_REPOSITORIES Repo-Liste (bei autodiscover ignoriert)
RENOVATE_HOST_RULES, RENOVATE_SECRETS JSON-Array bzw. JSON-Objekt
RENOVATE_ALLOWED_COMMANDS Regex-Liste für postUpgradeTasks
RENOVATE_BASE_DIR, RENOVATE_CACHE_DIR Arbeits- und Cache-Verzeichnis
RENOVATE_GIT_URL endpoint: Klon-URL aus dem Endpoint statt clone_url
LOG_LEVEL, LOG_FORMAT debug/info, json (ohne Präfix!)
LOG_FILE, LOG_FILE_LEVEL zusätzliche Logdatei, Level dafür (Default debug)

Ablageorte der Repo-Config

Renovate nimmt die erste gefundene Datei, weitere ignoriert es still (Tag 2): renovate.json, .jsonc, .json5, dasselbe unter .github/ und .gitlab/, dann .renovaterc, .renovaterc.json, .jsonc, .json5, zuletzt der Schlüssel renovate in package.json (deprecated). .forgejo/renovate.json liest 44.153.1 nicht.

Presets

Preset Wirkung
config:recommended Dashboard, Monorepo-Gruppen, Workarounds, ignorePaths
config:best-practices + Digests, Action-SHAs, :configMigration, npm-Reifezeit
config:js-app / config:js-lib alles pinnen / Bereiche für Bibliotheken
group:allNonMajor alle Minor/Patch in einen PR (renovate/all-minor-patch)
schedule:earlyMondays * 0-3 * * 1 (schedule:weekly verweist darauf)
:dependencyDashboard / :disableDependencyDashboard Dashboard an/aus
:configMigration PR, der veraltete Optionen umschreibt
:timezone(Europe/Berlin), :label(deps) Presets mit Parameter
:disableMajorUpdates major: {enabled: false}
:skipStatusChecks ignoreTests: true – nie produktiv
docker:pinDigests Image-Tags mit @sha256:
helpers:pinGitHubActionDigests uses: …@<sha> # v3 (…ToSemver: # v7.0.1)
security:minimumReleaseAgeNpm npm-Releases 3 Tage reifen lassen
security:only-security-updates nur noch Security-PRs (OSV)
:enableVulnerabilityAlertsWithLabel(security) Security-PRs mit Label
customManagers:dockerfileVersions # renovate:-Kommentar über ARG/ENV …_VERSION
customManagers:makefileVersions, …:gitlabPipelineVersions Makefile, GitLab CI

Quelltext: tools/node_modules/renovate/dist/config/presets/internal/*.preset.js. Defaults: jq '.definitions.<option>.default' auf …/renovate/renovate-schema.json. extends wirkt von links nach rechts, eigene Schlüssel schlagen jedes Preset, Arrays wie labels werden ersetzt. Einzelne Presets abwählen: ignorePresets (Tag 15).

packageRules-Matcher

Matcher prüft Beispiel
matchPackageNames Name: exakt, Glob, /regex/, !-Negation ["actions/*", "!actions/cache"]
matchUpdateTypes major, minor, patch, pin, digest … ["minor", "patch"]
matchManagers / matchDatasources Manager / Datasource ["npm"] / ["docker"]
matchDepTypes / matchFileNames Abschnitt / Datei (Glob) ["devDependencies"] / ["packages/**"]
matchCurrentVersion aktueller Wert "<5.0.0"
matchBaseBranches Ziel-Branch ["/^release\\/.+/"]
  • In einer Regel müssen alle Matcher passen, in einer Liste genügt einer.
  • Alle passenden Regeln wirken, die spätere gewinnt. labels ersetzt, addLabels addiert.
  • matchPackageNames prüft packageName, nicht den angezeigten depName.
  • Nur Negationen (["!@shop/**"]) treffen alles, was nicht ausgeschlossen ist.
  • Umbenannt: matchPackagePatterns/excludePackageNames → matchPackageNames, fileMatch → managerFilePatterns (/…/ = Regex), baseBranches → baseBranchPatterns.

Gruppieren, Planen, Begrenzen

Option Default Wirkung
groupName / groupSlug – gleicher Branchname = ein PR
separateMajorMinor true Major eigener PR, Gruppen-Branch major-…
separateMultipleMajor false je Major-Sprung eigener PR
separateMinorPatch false Patch getrennt, Gruppen-Branch patch-…
prHourlyLimit 2 neue PRs pro laufender Stunde (0 = aus)
prConcurrentLimit 10 offene Renovate-PRs
branchConcurrentLimit null (= PR-Limit) existierende Renovate-Branches
schedule + timezone jederzeit, UTC wann neue Branches entstehen
updateNotScheduled true bestehende PRs auch außerhalb pflegen
minimumReleaseAge null Reifezeit, Status renovate/stability-days
minimumReleaseAgeBehaviour timestamp-required ohne Zeitstempel nie reif
internalChecksFilter strict unreife Versionen gar nicht vorschlagen
dependencyDashboardApproval false Branch erst nach Häkchen (Tag 14)

Cron-Schedule: Minute immer * (* 0-5 * * 1 = montags 0:00–5:59). Die Textform (before 6am on monday) geht noch, Tippfehler darin sieht nur der Validator.

Automerge

{
  "platformAutomerge": false,
  "packageRules": [
    {
      "description": "devDependencies: patch/minor ohne PR, nur bei grünem CI",
      "matchDepTypes": ["devDependencies"],
      "matchUpdateTypes": ["patch", "minor"],
      "automerge": true,
      "automergeType": "branch",
      "automergeSchedule": ["* 0-5 * * *"]
    }
  ]
}
Option Default Merkpunkt
automerge false mergt erst, wenn alle Status success sind
automergeType pr branch: Fast-Forward auf main, PR nur bei Fehler
platformAutomerge true Forgejo mergt selbst beim ersten success
automergeSchedule jederzeit begrenzt nur den Merge
ignoreTests false true = Branch gilt immer als grün
internalChecksAsSuccess false nur renovate/*-Checks grün = gelb
rebaseWhen auto Automerge: behind-base-branch, sonst conflicted

Forgejo-Status → Renovate: unknown/pending gelb, success grün, Rest rot. Pro Context zählt der neueste Status. Ohne platformAutomerge mergt erst der nächste Lauf.

Versionen und Bereiche

rangeStrategy lodash ^4.17.20 (Lock 4.17.21) express ^4.18.2 → 5.3.0
auto (npm) wie update-lockfile wie update-lockfile
update-lockfile nur Lockfile → 4.18.1 ^5.0.0 (+ Lockfile-PR 4.x)
bump ^4.18.1 ^5.3.0 (+ ^4.22.3)
replace nichts (im Bereich) ^5.0.0
widen nichts (im Bereich) ^4.18.2 \|\| ^5.0.0
pin erst Pin-PR 4.17.21, dann exakt exakt
in-range-only nur Lockfile nichts, Major-PR geschlossen
Filter Beispiel Merkpunkt
allowedVersions "<5", "/^22\\./" hält dauerhaft fest, filtert keine Digests
matchCurrentVersion + enabled: false "<5.0.0" + major erledigt sich nach dem Major
ignoreDeps ["prettier"] Kurzform von enabled: false
followTag "latest-4", "next" folgt npm-Dist-Tag, auch abwärts
pinDigests true node:20.11.0-alpine@sha256:…
versioning "docker", "regex:…" unsupported/unversioned im Log = passt nicht

Node-Images haben Versioning node (nur LTS als Major-Ziel) durch workarounds:nodeDockerVersioning, Suffixe wie -alpine bleiben. go-Direktive anheben: matchDatasources: ["golang-version"] + rangeStrategy: "bump" (Tag 6).

customManagers

{
  "extends": ["config:recommended", "customManagers:dockerfileVersions"],
  "customManagers": [
    {
      "customType": "regex",
      "description": "kubectl im Tool-Image",
      "managerFilePatterns": ["/(^|/)Dockerfile$/"],
      "matchStrings": ["ARG KUBECTL_VERSION=(?<currentValue>\\S+)"],
      "depNameTemplate": "kubernetes/kubernetes",
      "datasourceTemplate": "github-releases"
    },
    {
      "customType": "regex",
      "managerFilePatterns": ["deploy.env"],
      "matchStringsStrategy": "combination",
      "matchStrings": ["DB_IMAGE=(?<depName>\\S+)", "DB_TAG=(?<currentValue>\\S+)"],
      "datasourceTemplate": "docker"
    },
    {
      "customType": "jsonata",
      "fileFormat": "yaml",
      "managerFilePatterns": ["tools.yaml"],
      "matchStrings": ["tools.{ \"depName\": repo, \"currentValue\": version }"],
      "datasourceTemplate": "github-releases"
    }
  ]
}

Kommentarkonvention der customManagers:*Versions-Presets: Felder in der Reihenfolge datasource, depName, packageName, versioning, extractVersion, registryUrl, direkt (ohne Leerzeile) über der Variablen:

# renovate: datasource=github-releases depName=kubernetes/kubernetes
ARG KUBECTL_VERSION=v1.29.0
  • Pflicht: depName, currentValue, datasource (Gruppe oder …Template). currentValue hat kein Template.
  • Regex ist RE2 auf dem ganzen Dateiinhalt, im JSON jeder Backslash doppelt.
  • matchStringsStrategy: any (Default), recursive, combination.
  • Tags mit Präfix (v, kustomize/v): extractVersion=^v(?<version>.*)$.
  • Eigene Quelle: customDatasources + datasource=custom.<name>, Format {"releases": [{"version": "…"}]}, sonst transformTemplates (Tag 7).
  • Der kubernetes-Manager hat keine Default-Muster: "kubernetes": {"managerFilePatterns": ["/(^|/)k8s/.+\\.yaml$/"]}. Manager helm gibt es nicht, nur helmv3 (Chart.yaml) und helm-values (Tag 3).

hostRules

Gehören in die globale Config bzw. RENOVATE_HOST_RULES. Im Repo nur mit Platzhaltern, Werte aus der globalen Option secrets (Tag 8):

{
  "hostRules": [
    {
      "matchHost": "http://127.0.0.1:3000/api/packages/",
      "hostType": "npm",
      "token": "{{ secrets.FORGEJO_PACKAGES }}"
    },
    {
      "matchHost": "127.0.0.1",
      "hostType": "docker",
      "username": "renovate-bot",
      "password": "{{ secrets.FORGEJO_PACKAGES }}",
      "insecureRegistry": true
    }
  ]
}
matchHost trifft
127.0.0.1 jeden Port, jedes Schema
127.0.0.1:3000 nur https://127.0.0.1:3000… (Port ohne Schema → https!)
http://127.0.0.1:3000/api/packages/ nur URLs mit genau diesem Präfix
  • hostType trennt Regeln für denselben Host (npm, docker, Plattform). Den Plattform-Token schickt Renovate nicht von selbst an die Registry.
  • Docker-Registry über HTTP nur mit insecureRegistry: true (nur Lab).
  • Globale npmrc ersetzt die Repo-.npmrc komplett, außer mit npmrcMerge: true.
  • secrets-Werte maskiert Renovate im Log; in branch*-, commit*-, group*-, pr*- und semantic*-Feldern sind Platzhalter verboten.

Globale config.js

// config.js – globale Konfiguration (Tag 9, Tag 10, Tag 12)
module.exports = {
  platform: 'forgejo',
  endpoint: 'http://127.0.0.1:3000/api/v1',
  token: process.env.RENOVATE_TOKEN,      // nie in die Datei schreiben
  gitAuthor: 'Renovate Bot <[email protected]>',
  autodiscover: true,
  autodiscoverFilter: ['*/*', '!lager/*'],
  onboardingBranch: 'renovate/onboarding',
  onboardingConfig: {
    $schema: 'https://docs.renovatebot.com/renovate-schema.json',
    extends: ['local>shop/renovate-config'],
  },
  repositoryCache: 'enabled',
  exitCodeForErrors: true,
  allowedCommands: ['^npm ci --ignore-scripts$', '^npm run format$'],
  secrets: { FORGEJO_PACKAGES: process.env.FORGEJO_PACKAGES_TOKEN },
};

Im Container oder Pod zusätzlich gitUrl: 'endpoint', denn Forgejo meldet als clone_url 127.0.0.1 (Tag 10). Nur global wirken u. a. platform, endpoint, token, gitUrl, autodiscover*, onboarding*, requireConfig, baseDir, cacheDir, repositoryCache, binarySource, allowedCommands, secrets, globalExtends, inheritConfig, internalHostAccess.

requireConfig Repo ohne Config Config im Repo
required (Default) Onboarding-PR gilt
optional globale Config, auch nach geschlossenem Onboarding-PR gilt
ignored globale Config wird nicht gelesen (auch enabled: false)
Exit Bedeutung
0 fertig, auch bei kaputter Repo-Config oder forbidden
1 FATAL beim Start (z. B. Authentication failure) oder Eintrag mit ERROR
3–8 nur mit exitCodeForErrors: true, z. B. 5 = Config-Fehler

Org-Presets

Referenz in extends lädt
local>shop/renovate-config default.json
local>shop/renovate-config:go go.json
local>shop/renovate-config//platform/k8s platform/k8s.json
local>shop/renovate-config:go/x Schlüssel x in go.json
local>shop/renovate-config#v1.1.0 default.json aus Git-Tag v1.1.0
local>shop/renovate-config:team(team-shop, lab-admin) {{arg0}}, {{arg1}}
  • Jede Referenz braucht ihr eigenes #tag. Ohne Tag gilt main sofort überall.
  • local> liest mit dem Bot-Token, Leserecht genügt. Fehlt es: 404 → „Cannot find preset’s package” → Config-Fehler-Issue (Tag 11).
  • Onboarding findet <org>/renovate-config mit default.json selbst und schreibt es ohne Tag in den PR – noch vor onboardingConfig.
  • globalExtends wird vor der Plattform aufgelöst, local> landet bei github.com. Nimm eine ohne Token lesbare URL (…/raw/tag/v1.1.0/default.json).
  • inheritConfig: true holt org-inherited-config.json aus {{parentOrg}}/renovate-config, mit Bot-Token.

Monorepos und PR-Gestaltung

{
  "semanticCommits": "enabled",
  "labels": ["deps"],
  "reviewers": ["alice"],
  "baseBranchPatterns": ["main", "/^release\\/.+/"],
  "lockFileMaintenance": { "enabled": true },
  "prBodyNotes": ["Betreut von Team Shop, Fragen im Kanal #shop-deps."],
  "packageRules": [
    {
      "description": "Go-Worker",
      "matchFileNames": ["services/worker/**"],
      "addLabels": ["worker"],
      "additionalBranchPrefix": "{{parentDir}}-",
      "semanticCommitType": "build",
      "semanticCommitScope": "worker",
      "postUpdateOptions": ["gomodTidy"]
    },
    {
      "description": "Release-Branches: nur Patches (Patch sonst im Minor)",
      "matchBaseBranches": ["/^release\\/.+/"],
      "separateMinorPatch": true
    },
    {
      "matchBaseBranches": ["/^release\\/.+/"],
      "matchUpdateTypes": ["major", "minor", "lockFileMaintenance"],
      "enabled": false
    }
  ]
}
  • npm-Workspaces: ein Update in mehreren package.json = ein Branch, Lockfile immer im Wurzelverzeichnis.
  • Commit/Titel: commitMessagePrefix commitMessageAction commitMessageTopic commitMessageExtra commitMessageSuffix. prTitle direkt ist deprecated.
  • {{parentDir}} = worker, {{packageFileDir}} = services/worker.
  • lockFileMaintenance: Default-Schedule before 4am on monday, nicht für gomod.
  • baseBranchPatterns: Branchnamen mit Ziel-Präfix, Titel mit Suffix (main). Config kommt vom Default-Branch (sonst useBaseBranchConfig: "merge").
  • Reviewer und Assignees setzt Renovate nur beim Anlegen eines PRs, bei Automerge nur mit assignAutomerge: true (Tag 13).

Sicherheit

{
  "extends": ["config:best-practices"],
  "osvVulnerabilityAlerts": true,
  "dependencyDashboardOSVVulnerabilitySummary": "unresolved",
  "vulnerabilityAlerts": {
    "labels": ["security"],
    "vulnerabilityFixStrategy": "highest"
  }
}
  • OSV prüft nur direkte Abhängigkeiten, und zwar die Lockfile-Version. Die Offline-DB braucht rund 600 MB entpackt.
  • vulnerabilityAlerts liest Plattform-Alerts – das kann nur GitHub. Security-PRs ignorieren schedule, Limits und minimumReleaseAge.
  • vulnerabilityFixStrategy: lowest (Default, kleinster Fix) oder highest.
  • postUpgradeTasks (commands, fileFilters) laufen nur, wenn global allowedCommands (Regex, ^…$) passt; ohne Shell, also kein && (Tag 12).
  • Bot: kein Admin, nur die nötigen Scopes, keine Ausnahme im Branch-Schutz (Tag 12).

Dependency Dashboard

Häkchen per API: Marker im HTML-Kommentar von - [ ] auf - [x] setzen, Body per PATCH zurückschreiben (tick aus code/tag14/fj.sh). Renovate handelt beim nächsten Lauf und hakt wieder aus. Checkboxen übergehen alle Limits.

Abschnitt Ursache Marker <typ>-branch=… Sammel-Checkbox
Repository Problems WARN/ERROR im Lauf – –
Pending Approval dependencyDashboardApproval approve approve-all-pending-prs
Awaiting Schedule schedule unschedule create-all-awaiting-schedule-prs
Rate-Limited Limits unlimit create-all-rate-limited-prs
Errored Fehler im Branch retry –
PR Edited (Blocked) fremder Commit im Branch rebase –
Pending Status Checks minimumReleaseAge unpend –
Open offene PRs rebase rebase-all-open-prs
PR Closed (Blocked) geschlossener PR recreate –
  • Im PR selbst: Marker rebase-check, alternativ Label rebase (rebaseLabel) oder ein Titel, der mit rebase! beginnt.
  • recreateWhen: auto (Default, nur Gruppen, Digests, Lockfile-Pflege kommen zurück), always, never.
  • Renovate findet das Dashboard nur über dependencyDashboardTitle. Titel ändern hinterlässt das alte Issue verwaist.

Forgejo-API-Einzeiler

R="$FORGEJO/api/v1/repos/shop/shop-api"
api() { curl -sf -u "$ADMIN" -H 'Content-Type: application/json' "$@"; }
api "$R/pulls?state=open&limit=50" | jq -r '.[] | "#\(.number) \(.head.ref) \(.title)"'
api "$R/issues?type=issues&state=open" | jq -r '.[] | "#\(.number) \(.title)"'
api "$R/issues/4" | jq -r .body                          # Dashboard-Text
api "$R/raw/renovate.json?ref=renovate/configure"
api -X POST "$R/pulls/2/merge" -d '{"Do":"merge","delete_branch_after_merge":true}'
api -X PATCH "$R/pulls/8" -d '{"state":"closed"}'        # = Update ignorieren
SHA=$(api "$R/branches/renovate%2Fprettier-3.x" | jq -r .commit.id)
api -X POST "$R/statuses/$SHA" -d '{"state":"success","context":"ci/test"}'
api "$R/commits/renovate%2Fprettier-3.x/status" \
  | jq -r '.statuses[] | "\(.context) = \(.status)"'
api -X PATCH "$R" -d '{"has_actions":false}'             # Forgejo Actions aus
api -X POST "$R/branch_protections" -d '{"rule_name":"main",
  "enable_status_check":true,"status_check_contexts":["ci/test"]}'
api -X PUT "$R/collaborators/renovate-bot" -d '{"permission":"write"}'
curl -s -H "Authorization: token $RENOVATE_TOKEN" "$R" | jq -c .permissions
curl -s -u renovate-bot:lab-bot-pw-123 \
  "$FORGEJO/api/v1/users/renovate-bot/tokens" | jq -r '.[].scopes | join(",")'

Forgejo nummeriert Issues und PRs gemeinsam. Unbekannte Labels verwirft es still, Org-Labels legst du unter /orgs/shop/labels an.

jq-Rezepte für JSON-Logs

Log erzeugen mit LOG_LEVEL=debug LOG_FORMAT=json renovate … > lauf.json 2>&1. Die Funktionen liegen in code/tag14/rezepte.sh.

jq -r .level lauf.json | sort | uniq -c                 # 20 debug … 60 fatal
jq -r 'select(.level >= 40) | "\(.level) \(.branch // "-") \(.msg)"' lauf.json
jq -r 'select(.msg == "packageFiles with updates") | .config[][]
  | .packageFile as $f | .deps[] | "\($f): \(.depName) \(.currentValue // "")"
  + " -> \([.updates[]? | .newVersion] | join(", "))"
  + (if .skipReason then " [skip: \(.skipReason)]" else "" end)' lauf.json
jq -r 'select(.msg == "branches info extended") | .branchesInformation[]
  | "\(.result)\t#\(.prNo // "-")\t\(.branchName)"' lauf.json
jq -r --arg b renovate/node-24.x 'select(.branch == $b) | .msg' lauf.json
jq -r 'select(.msg == "Repository finished")
  | "\(.repository)\t\(.durationMs) ms\t\(.result)"' lauf.json
jq -r '.. | objects | select(.skipReason?) | "\(.depName): \(.skipReason)"' \
  report.json                                           # --report-type=file

branches-Ergebnisse: done, pr-created, needs-approval, not-scheduled, pr-limit-reached, already-existed, pr-edited, error. result in „Repository finished”: done, onboarding, disabled-*, config-validation, forbidden.

Fehlerbilder

Symptom Ursache Abhilfe
Unsupported node environment, Exit 1 Node 25+ oder < 24.11 Node 24 LTS (Tag 0)
github-token-required kein github.com-Token RENOVATE_GITHUB_COM_TOKEN
Repository is empty - skipping Push noch nicht verarbeitet Lauf wiederholen
"result": "onboarding" Onboarding-PR nicht gemergt mergen oder Config auf main
nur 2 PRs, Rest „Rate-Limited” prHourlyLimit 2 (Default) Limit setzen oder Checkbox
Issue „Action Required: Fix Renovate Configuration” JSON, Option, Preset, Secret Validator, reparieren
„Found renovate config warnings” Global-Option in Repo-Config in config.js verschieben
FATAL: Authentication failure Token falsch, mit \n oder zu wenig Scopes GET /api/v1/user mit Token
result: forbidden, still Bot ohne Schreibrecht Collaborator write
Failed to look up … no-result 401, keine hostRules Regel mit passendem matchHost
-1 https://…/v2/…, wrong version number Docker-Registry nur HTTP insecureRegistry: true
HTTP request to an internal host internalHostAccess=warn hostRules-Eintrag
renovate/artifacts: failure Werkzeug, E404, Peer-Konflikt, Allowlist auf main beheben, rebase-check
No dependencies found in file Regex trifft nicht (Datei schon) Regex mit --platform=local testen
Automerge hängt, Branch status yellow Check nie fertig (Actions ohne Runner) has_actions: false oder Runner
Update fehlt still minimumReleaseAge ohne Zeitstempel, skipReason timestamp-optional, Log
„PR Edited (Blocked)” fremder Commit im Renovate-Branch rebase-check
PR „- autoclosed” nicht mehr gewollt oder Lookup-Fehler (Token!) Config, hostRules prüfen

Fallen

  • Node 25 lokal: Renovate läuft, endet aber mit Exit 1, RE2 fehlt (Tag 0).
  • Onboarding-PR self-hosted enthält nur $schema, kein config:recommended.
  • PR schließen = ganze Major-Linie ignorieren, die Sperre hängt am Titel (Tag 1).
  • semanticCommits: auto: Commits wie config: … auf main schalten PR-Titel auf fix(deps):/chore(deps):; fix löst bei semantic-release ein Release aus.
  • ignorePaths ist nicht mergebar: eigene Liste ersetzt :ignoreModulesAndTests.
  • Config-Änderung baut bestehende Branches nicht neu, erst Rebase oder Konflikt.
  • Branch-Präfix ändern (additionalBranchPrefix, separateMinorPatch, baseBranchPatterns) schließt alle betroffenen PRs als „autoclosed”.
  • platformAutomerge ohne Branch-Protection: Forgejo mergt beim ersten beliebigen success, auch wenn ci/test rot ist (Tag 5).
  • automergeType: branch mit Bot in der Push-Whitelist umgeht Pflicht-Checks.
  • Kaputte Repo-Config und fehlendes Schreibrecht: Exit 0 (Tag 9, Tag 14).
  • autodiscover: Repo-Argumente sind kein Filter, RENOVATE_REPOSITORIES wird ignoriert – zusätzlich RENOVATE_AUTODISCOVER=false (Tag 9, Tag 10).
  • source env.sh setzt RENOVATE_ENDPOINT & Co. und überstimmt config.js.
  • concurrencyPolicy: Forbid kennt manuelle Jobs nicht (Tag 10).
  • Tippfehler im Paketnamen (expresss) installiert oft Fremdcode statt eines Lookup-Fehlers (Tag 14).
  • group:monorepos abwählen: Peer-Paare wie react/react-dom brauchen dann eine eigene Gruppe, sonst ERESOLVE im Lockfile (Tag 15).
  • permissions.push der API ist das Recht des Benutzers, nicht des Tokens.