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.