Tag 2: Konfiguration verstehen
Ziel: Du liest, prüfst und testest eine Renovate-Konfiguration, bevor sie wirkt, und steuerst einzelne Updates gezielt mit
packageRules. · Dauer: ca. 90 min · Voraussetzung: Tag 1
Briefing
- Die Repo-Config ist eine Datei im Default-Branch. Renovate nimmt die erste gefundene aus einer festen Liste von Ablageorten, alle weiteren ignoriert es still.
extendslädt Presets von links nach rechts. Spätere überschreiben frühere, eigene Schlüssel in der Datei überschreiben alle Presets.packageRuleswerden alle geprüft. Jede passende Regel wird angewendet, eine spätere überschreibt dieselbe Option einer früheren.- Prüfen ohne Risiko:
renovate-config-validator,--dry-run,--platform=local.
Renovate-Defaults ─► extends[0] ─► extends[1] ─► … ─► eigene Schlüssel
│
je Update: packageRules[0] ─► packageRules[1] ─► … ─────┘ (nur wenn alle
match*-Felder passen)
Drill 1: Ausgangslage
Du startest mit einem frischen shop-api und legst die
Config direkt auf main. Liegt eine Config im
Default-Branch, gilt das Repo als onboarded, ein Onboarding-PR
entfällt.
source ~/renovate-lab/setup/env.sh && ~/renovate-lab/setup/check.sh
export RENOVATE_GITHUB_COM_TOKEN=$(gh auth token) # optional, siehe Tag 0
~/renovate-lab/setup/seed.sh --reset
mkdir -p ~/renovate-lab/tag02 && cd ~/renovate-lab/tag02
rm -rf shop-api
git clone -q http://lab-admin:[email protected]:3000/shop/shop-api.git
cd shop-api
git config user.name "Lab Admin" && git config user.email [email protected]
cat > renovate.json <<'EOF'
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": ["config:recommended"]
}
EOF
git add renovate.json && git commit -qm "Renovate-Konfiguration" && git push -q
git log --onelineErwartet (gekürzt, Hashes weichen ab):
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
2340402 Renovate-Konfiguration
a8b2fdb Initialer Stand
seed.sh --reset löscht das Repo samt PRs und Issues aus
Tag 1. Die Commit-Meldungen sind bewusst ohne
typ: text-Muster gewählt, warum, zeigt Drill 7.
Fortschritt speichern? Kostenlos registrieren
Drill 2: config:recommended aufgeschlüsselt
Presets sind kein Zauber, sondern JavaScript-Objekte im installierten Paket. Lies die Definition dort, wo deine Renovate-Version sie wirklich hernimmt.
P=~/renovate-lab/tools/node_modules/renovate/dist/config/presets/internal
awk '/^\trecommended: \{/,/\]/' $P/config.preset.js | expand -t2 | cut -c1-80
awk '/^\tdependencyDashboard: \{/,/\}/' $P/default.preset.js | expand -t2Erwartet:
recommended: {
description: "Recommended configuration for most users. It does not matter w
extends: [
":dependencyDashboard",
":semanticPrefixFixDepsChoreOthers",
":ignoreModulesAndTests",
"group:monorepos",
"group:recommended",
"mergeConfidence:age-confidence-badges",
"replacements:all",
"workarounds:all",
"helpers:forgejoDigestChangelogs",
"helpers:giteaDigestChangelogs",
"helpers:githubDigestChangelogs",
"helpers:gitlabDigestChangelogs",
"helpers:goXPackagesChangelogLink",
"helpers:goXPackagesNameLink",
"helpers:renovateChangelog"
]
dependencyDashboard: {
dependencyDashboard: true,
description: "Enable Renovate Dependency Dashboard creation."
},
Presets ohne Präfix (:name) liegen in
default.preset.js, group: in
group.preset.js und so weiter. Was davon nach dem Auflösen
übrig bleibt, zeigt --print-config. Den Vergleich mit einer
leeren Config machst du lokal: renovate.json im
Arbeitsverzeichnis ändern genügt, ohne Commit.
cfg() {
LOG_FORMAT=json renovate --platform=local --dry-run=extract --print-config=true \
2>&1 | jq -c 'select(.config.packageRules) | .config | {dependencyDashboard,
ignorePaths: (.ignorePaths|length), packageRules: (.packageRules|length)}'
}
cfg
echo '{}' > renovate.json && cfg
git checkout -q renovate.jsonErwartet:
{"dependencyDashboard":true,"ignorePaths":8,"packageRules":729}
{"dependencyDashboard":false,"ignorePaths":2,"packageRules":0}
729 Regeln stecken hinter einer Zeile, live gezählt: 523 mit
groupName (aus group:*), 155 Ersetzungen
(replacements:all), der Rest aus
workarounds:*, helpers:* und
:semanticPrefixFixDepsChoreOthers.
| Baustein | Wirkung |
|---|---|
:dependencyDashboard |
Issue „Dependency Dashboard” (Tag 14) |
:semanticPrefixFixDepsChoreOthers |
fix für dependencies, sonst
chore – nur bei Semantic Commits |
:ignoreModulesAndTests |
ignorePaths für node_modules,
vendor, test, examples … |
group:monorepos, group:recommended |
bekannte Paketfamilien landen in einem PR (Tag 4) |
replacements:all |
PRs für umbenannte oder ersetzte Pakete |
workarounds:all |
Korrekturen für Pakete mit schrägen Versionen |
mergeConfidence:age-confidence-badges |
Spalten Age/Confidence im PR-Text |
helpers:*Changelogs, helpers:*Link |
bessere Changelog- und Quell-Links |
Achtung:
--print-config shop/shop-apischeitert mit „Invalid boolean value: expected ‘true’ or ‘false’, but got ‘shop/shop-api’“. Die Option frisst das nächste Argument. Schreib--print-config=true.
Fortschritt speichern? Kostenlos registrieren
Drill 3: extends – Reihenfolge und Überschreiben
Vier Varianten, dasselbe Werkzeug.
:disableDependencyDashboard setzt
dependencyDashboard: false, :label(…) ist ein
Preset mit Parameter.
dd() {
echo "$1" > renovate.json
LOG_FORMAT=json renovate --platform=local --dry-run=extract --print-config=true \
2>&1 | jq -c 'select(.config.packageRules) | .config
| {dependencyDashboard, labels}'
}
dd '{"extends":["config:recommended",":disableDependencyDashboard"]}'
dd '{"extends":[":disableDependencyDashboard","config:recommended"]}'
dd '{"extends":["config:recommended",":label(deps)"]}'
dd '{"extends":[":label(deps)"],"labels":["eigenes"],"dependencyDashboard":true}'
git checkout -q renovate.jsonErwartet:
{"dependencyDashboard":false,"labels":[]}
{"dependencyDashboard":true,"labels":[]}
{"dependencyDashboard":true,"labels":["deps"]}
{"dependencyDashboard":true,"labels":["eigenes"]}
Zeile 2 ist die Falle: config:recommended steht hinten
und schaltet das Dashboard wieder ein. Zeile 4 zeigt die Regel „Datei
schlägt Preset”. Arrays wie labels werden dabei ersetzt,
nicht ergänzt.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Ablageorte und ihre Priorität
--platform=local liest nur Dateien, die Git kennt
(git ls-files). Ein git add reicht, committen
musst du nicht. Du legst alle Kandidaten an und nimmst sie einzeln
wieder aus dem Index.
cd ~/renovate-lab/tag02 && rm -rf prio && cp -R shop-api prio && cd prio
mkdir -p .github .gitlab .forgejo
for f in renovate.json5 .github/renovate.json .gitlab/renovate.json \
.renovaterc .forgejo/renovate.json; do echo '{}' > $f; done
git add -A
for f in renovate.json renovate.json5 .github/renovate.json .gitlab/renovate.json \
.renovaterc .forgejo/renovate.json; do
printf '%-24s -> ' "$f"
LOG_LEVEL=debug renovate --platform=local --dry-run=extract 2>&1 \
| grep -oE "Found .* config file|No renovate config file found"
git rm -q --cached $f
doneErwartet:
renovate.json -> Found renovate.json config file
renovate.json5 -> Found renovate.json5 config file
.github/renovate.json -> Found .github/renovate.json config file
.gitlab/renovate.json -> Found .gitlab/renovate.json config file
.renovaterc -> Found .renovaterc config file
.forgejo/renovate.json -> No renovate config file found
No renovate config file found
Die vollständige Liste in 44.153.1 (aus
dist/config/app-strings.js): renovate.json,
renovate.jsonc, renovate.json5, dasselbe unter
.github/ und .gitlab/,
.renovaterc, .renovaterc.json,
.renovaterc.jsonc, .renovaterc.json5, zuletzt
der Schlüssel renovate in package.json.
jq '. + {renovate: {extends: ["config:recommended"]}}' package.json > p.json
mv p.json package.json
LOG_LEVEL=debug renovate --platform=local --dry-run=extract 2>&1 \
| grep -E "Found .* config file|deprecated" | cut -c1-80
cd ~/renovate-lab/tag02 && rm -rf prioErwartet:
WARN: Using package.json for Renovate config is deprecated - please use a dedic
DEBUG: Found package.json config file (repository=local)
"⚠️ WARN: Using package.json for Renovate config is deprecated - please
Achtung:
.github/renovate.jsonund.gitlab/renovate.jsongelten auf jeder Plattform, auch auf Forgejo..forgejo/renovate.jsondagegen liest 44.153.1 nicht, auch nicht mitRENOVATE_PLATFORM=forgejo(live geprüft: „Repo is not onboarded”). Liegen zwei Configs im Repo, gewinnt die erste der Liste – ohne Warnung.
Fortschritt speichern? Kostenlos registrieren
Drill 5: JSON5 und renovate-config-validator
JSON5 erlaubt Kommentare, Schlüssel ohne Anführungszeichen und Kommas am Ende. Ideal, um Regeln zu begründen. Zuerst eine absichtlich kaputte Datei:
mkdir -p ~/renovate-lab/tag02/kaputt && cd ~/renovate-lab/tag02/kaputt
cat > renovate.json5 <<'EOF'
{
// Absichtlich fehlerhaft
extends: ["config:recommended"],
prHourlyLimt: 4,
packageRules: [
{
matchPackagePatterns: ["^@types/"],
labels: ["types"],
},
],
}
EOF
renovate-config-validator 2>&1 | grep -E '^ ?[A-Z]+:|^ +[-+] |"message"'
echo "exit=${PIPESTATUS[0]}"Erwartet:
INFO: Validating renovate.json5
WARN: Config migration necessary
WARN: Config migration diff:
- "matchPackagePatterns": [
- "^@types/"
- ],
+ ],
+ "matchPackageNames": [
+ "/^@types//"
ERROR: Found errors in configuration
"message": "Invalid configuration option: prHourlyLimt"
exit=1
Zwei Befunde: Der Tippfehler ist ein Fehler, die veraltete Option nur
eine Warnung mit Migrationsvorschlag (/…/ heißt Regex,
Drill 7). Ohne Argumente prüft der Validator alle Ablageorte aus Drill 4
im aktuellen Verzeichnis. Jetzt den Tippfehler beheben:
sed -i.bak 's/prHourlyLimt/prHourlyLimit/' renovate.json5 && rm renovate.json5.bak
renovate-config-validator >/dev/null 2>&1; echo "normal: exit=$?"
renovate-config-validator --strict >/dev/null 2>&1; echo "--strict: exit=$?"
echo '{"extends": ["config:recomended"]}' > tippfehler.json
renovate-config-validator --no-global tippfehler.json; echo "exit=$?"Erwartet:
normal: exit=0
--strict: exit=1
INFO: Validating tippfehler.json as repo config
INFO: Config validated successfully against 1 file(s)
exit=0
--strict macht eine nötige Migration zum Fehler – genau
richtig für CI. Übergibst du Dateinamen, prüft der Validator sie als
globale Config. --no-global schaltet auf
Repo-Config. Den Preset-Tippfehler config:recomended sieht
er nicht, weil er Presets nicht auflöst. Das kann nur ein echter
Lauf:
mkdir -p ~/renovate-lab/tag02/preset-test && cd ~/renovate-lab/tag02/preset-test
git init -q && cp ../kaputt/tippfehler.json renovate.json && git add renovate.json
renovate --platform=local --dry-run=extract 2>&1 | grep -E "validationError|DRY-RUN"
cd ~/renovate-lab/tag02 && rm -rf preset-testErwartet:
"validationError": "Cannot find preset's package (config:recomended)"
"validationError": "Cannot find preset's package (config:recomended)",
INFO: DRY-RUN: Would ensure configuration error issue (repository=local)
"validationError": "Cannot find preset's package (config:recomended)",
Auf Forgejo wäre das ein Issue „Action Required: Fix Renovate Configuration”, und Renovate legt keine PRs mehr an, bis die Config repariert ist.
Fortschritt speichern? Kostenlos registrieren
Drill 6: –dry-run=extract|lookup|full und –platform=local
Drei Stufen, jede macht einen Schritt mehr. Die Zeitaufteilung im Debug-Log zeigt, was wirklich passiert ist.
cd ~/renovate-lab/tag02
for m in extract lookup full; do
LOG_LEVEL=debug renovate --dry-run=$m shop/shop-api > dry-$m.log 2>&1
printf '%-8s %s DRY-RUN-Zeilen: %s\n' $m \
"$(grep -o '"lookup": [0-9]*, "update": [0-9]*' dry-$m.log)" \
"$(grep -c '^ INFO: DRY-RUN' dry-$m.log)"
done
grep -h '^ INFO: DRY-RUN' dry-full.log | cut -c1-70 | head -3Erwartet (Millisekunden schwanken):
extract "lookup": 0, "update": 0 DRY-RUN-Zeilen: 0
lookup "lookup": 4860, "update": 0 DRY-RUN-Zeilen: 0
full "lookup": 356, "update": 3368 DRY-RUN-Zeilen: 9
INFO: DRY-RUN: Would commit files to branch renovate/express-4.x. See
INFO: DRY-RUN: Would commit files to branch renovate/prettier-3.x. Se
INFO: DRY-RUN: Would commit files to branch renovate/node-20.x. See d
| Modus | Fragt Registries | Baut Branches lokal | Schreibt in Forgejo |
|---|---|---|---|
extract |
nein | nein | nein |
lookup |
ja | nein | nein |
full |
ja | ja (inkl. Lockfile) | nein |
Alle drei brauchen Forgejo zum Klonen. --platform=local
kommt ganz ohne Plattform aus und nimmt das aktuelle Verzeichnis:
cd ~/renovate-lab/tag02/shop-api
renovate --platform=local 2>&1 | sed -n '/extraction complete/,/total/p'
LOG_LEVEL=debug renovate --platform=local --dry-run=full 2>&1 \
| grep -o '"lookup": [0-9]*, "update": [0-9]*'Erwartet:
INFO: Dependency extraction complete (repository=local, baseBranch=)
"stats": {
"managers": {
"dockerfile": {"fileCount": 1, "depCount": 1},
"github-actions": {"fileCount": 1, "depCount": 4},
"npm": {"fileCount": 1, "depCount": 3}
},
"total": {"fileCount": 3, "depCount": 8}
"lookup": 293, "update": 0
local schreibt nie: Ohne Angabe läuft es als
lookup, auch --dry-run=full endet mit
"update": 0. Kein Token, kein Klon, keine Issues. Gut für
Pre-Commit-Checks und um eine Config auszuprobieren, bevor du sie
pushst.
Fortschritt speichern? Kostenlos registrieren
Drill 7: packageRules mit sichtbarer Wirkung
Jetzt bekommt jeder Matcher eine Regel, deren Wirkung du am PR
siehst. Forgejo hängt nur Labels an, die im Repo (oder in der Org)
existieren, also zuerst anlegen. Die Config liegt auch unter
~/renovate-lab/code/tag02/renovate.json5.
for l in npm:1d76db web:0e8a16 ci:5319e7 docker:0052cc major:d93f0b; do
curl -sf -u "$ADMIN" -H 'Content-Type: application/json' -X POST \
"$FORGEJO/api/v1/repos/shop/shop-api/labels" \
-d "{\"name\":\"${l%%:*}\",\"color\":\"#${l##*:}\"}" | jq -r .name
done
cd ~/renovate-lab/tag02/shop-api && git rm -q renovate.json
cat > renovate.json5 <<'EOF'
{
$schema: "https://docs.renovatebot.com/renovate-schema.json",
extends: ["config:recommended"],
prHourlyLimit: 0, // Lab: alle PRs in einem Lauf (Details: Tag 4)
packageRules: [
{
description: "Manager: alle npm-Updates",
matchManagers: ["npm"],
labels: ["npm"],
},
{
description: "exakter Name: express bekommt zusätzlich web",
matchPackageNames: ["express"],
addLabels: ["web"],
},
{
description: "Glob: alle Actions der Org actions",
matchPackageNames: ["actions/*"],
labels: ["ci"],
},
{
description: "Regex + Datei + Datasource: Basis-Image im Dockerfile",
matchFileNames: ["Dockerfile"],
matchDatasources: ["docker"],
matchPackageNames: ["/^node$/"],
labels: ["docker"],
},
{
description: "Majors außer Actions: überschreibt labels von oben",
matchUpdateTypes: ["major"],
matchPackageNames: ["!actions/*"],
labels: ["major"],
},
{
description: "devDependencies vorerst aus",
matchDepTypes: ["devDependencies"],
enabled: false,
},
],
}
EOF
renovate-config-validator --strict && git add -A \
&& git commit -qm "packageRules als JSON5" && git push -q
renovate shop/shop-api 2>&1 | grep -cE "PR created"
curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/pulls?state=open" \
| jq -r '.[] | "#\(.number) [\([.labels[].name]|join(","))] \(.title)"'Erwartet (Zielversionen sind bei dir neuer):
npm
web
ci
docker
major
INFO: Validating renovate.json5
INFO: Config validated successfully against 1 file(s)
6
#6 [ci,major] Update dependency node to v24
#5 [major,web] Update dependency express to v5
#4 [ci] Update actions/setup-node action to v7
#3 [ci] Update actions/checkout action to v7
#2 [docker] Update Node.js to v20.20.2
#1 [npm,web] Update dependency express to v4.22.3
So liest du das Ergebnis:
- #1 passt auf Regel 1 (
npm) und 2 (addLabelsaddiertweb). - #5 passt zusätzlich auf Regel 5.
labelsist nicht mergebar,majorersetztnpm.addLabelsist mergebar,webbleibt. - #3/#4 bleiben
ci, weil die Negation!actions/*sie aus Regel 5 nimmt. - #6 bündelt
nodeimDockerfileundnode-versioninci.yml(gleicher Branchrenovate/node-24.x). Labels aller Updates im Branch werden vereinigt. Woher kommtci? Der Matcher prüft denpackageName, nicht den angezeigten Namen. - prettier fehlt, Regel 6 hat es abgeschaltet.
- Fehlt
RENOVATE_GITHUB_COM_TOKEN, überspringt Renovate die Actions und die Node-Version im Workflow (github-token-required). Dann fehlen #3, #4 und dieci.yml-Hälfte von #6.
LOG_LEVEL=debug renovate --dry-run=lookup shop/shop-api 2>&1 \
| grep -E '"packageName": "actions/node-versions"|prettier, is disabled'Erwartet:
DEBUG: Dependency: prettier, is disabled (repository=shop/shop-api)
"packageName": "actions/node-versions",
Die Matcher im Überblick:
| Matcher | prüft | Beispiel |
|---|---|---|
matchPackageNames |
Paketname: exakt, Glob, /regex/,
!-Negation |
["actions/*", "!actions/cache"] |
matchUpdateTypes |
major, minor, patch,
pin, digest … |
["major"] |
matchManagers / matchDatasources |
Manager / Datasource | ["npm"] / ["docker"] |
matchDepTypes / matchFileNames |
Abschnitt / Datei (Glob) | ["devDependencies"] / ["Dockerfile"] |
Innerhalb einer Regel müssen alle Matcher passen
(UND), innerhalb einer Liste genügt einer (ODER). Globs sind
case-insensitiv, * allein passt auf alles.
Tipp: Sieh dir die PR-Titel an, nachdem du ein paar Commits wie
fix: …gepusht hast.semanticCommitssteht aufauto: Überwiegen in den letzten Commits aufmainMeldungen im Mustertyp: text, schreibt Renovatefix(deps): update …fürdependenciesundchore(deps): …für alles andere. Das ist:semanticPrefixFixDepsChoreOthersaus Drill 2. Live beobachtet, schon Meldungen wieRenovate: neue Regelzählen mit.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Veraltete Optionen und configMigration
Renovate migriert alte Optionen bei jedem Lauf intern. Mit
:configMigration öffnet es zusätzlich einen PR, der die
Datei umschreibt. Du baust die alte Schreibweise absichtlich ein.
cd ~/renovate-lab/tag02/shop-api
sed -i.bak -e 's/"config:recommended"\]/"config:recommended", ":configMigration"]/' \
-e 's/matchPackageNames: \["express"\]/matchPackagePatterns: ["^express$"]/' \
renovate.json5 && rm renovate.json5.bak
grep -nE 'extends|matchPackagePatterns' renovate.json5
renovate-config-validator >/dev/null 2>&1 \
&& git commit -qam "Alte Option" && git push -q
renovate shop/shop-api 2>&1 | grep -i "migration"
git fetch -q
git diff main origin/renovate/migrate-config | grep -E '^[-+] ' | head -8
curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/pulls?state=open" \
| jq -r '.[] | select(.head.ref=="renovate/migrate-config") | .body' \
| grep -o 'JSON5 config file migrated.*removed.'Erwartet:
3: extends: ["config:recommended", ":configMigration"],
13: matchPackagePatterns: ["^express$"],
INFO: Migration PR created (repository=shop/shop-api)
- $schema: "https://docs.renovatebot.com/renovate-schema.json",
- extends: ["config:recommended", ":configMigration"],
- prHourlyLimit: 0, // Lab: alle PRs in einem Lauf (Details: Tag 4)
+ $schema: 'https://docs.renovatebot.com/renovate-schema.json',
+ extends: [
+ 'config:recommended',
+ ':configMigration',
+ ],
+ prHourlyLimit: 0,
JSON5 config file migrated! All comments & trailing commas were removed.
Der PR „Migrate Renovate config” (#8, die #7 ist das Dependency Dashboard: Issues und PRs teilen sich in Forgejo die Nummern) würde deine Kommentare löschen. Besser: von Hand migrieren. Renovate schließt den PR dann selbst.
sed -i.bak 's|matchPackagePatterns: \["^express\$"\]|matchPackageNames: ["express"]|' \
renovate.json5 && rm renovate.json5.bak
renovate-config-validator --strict >/dev/null 2>&1 && echo "✔ keine Migration nötig"
git commit -qam "Migration von Hand" && git push -q
renovate shop/shop-api 2>&1 | grep -E "Autoclosing"
curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/pulls?state=closed" \
| jq -r '.[] | "#\(.number) \(.title)"'Erwartet:
✔ keine Migration nötig
INFO: Autoclosing PR (repository=shop/shop-api)
#8 Migrate Renovate config - autoclosed
Es gibt kein Preset config:migration. Die Option heißt
configMigration, das Preset :configMigration,
und es steckt in config:best-practices, nicht in
config:recommended.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
cd ~/renovate-lab/tag02/shop-api && git pull -q
api() { curl -sf -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/$1"; }
[ -f renovate.json5 ] && [ ! -f renovate.json ] \
&& echo "✔ Config liegt in renovate.json5" || echo "✘ renovate.json5 fehlt"
renovate-config-validator --strict >/dev/null 2>&1 \
&& echo "✔ Validator --strict ohne Befund" || echo "✘ Validator meldet etwas"
api "pulls?state=open" | jq -e '.[] | select(.title|test("express to v5"))
| .labels | map(.name) | (index("major") and index("web"))' >/dev/null \
&& echo "✔ express v5 hat major+web" || echo "✘ Labels an express v5 falsch"
api "pulls?state=open" | jq -e 'map(select(.title|test("prettier"))) | length == 0' \
>/dev/null && echo "✔ kein prettier-PR (devDependencies aus)" \
|| echo "✘ prettier-PR offen"
api "pulls?state=closed" | jq -e 'any(.title|test("Migrate Renovate config"))' \
>/dev/null && echo "✔ Migrations-PR geschlossen" || echo "✘ Migrations-PR fehlt"Challenge
Ändere die Config so, dass Updates von devDependencies
nicht mehr abgeschaltet sind, sondern zusätzlich das Label
dev bekommen, und dass Major-Updates vorerst gar nicht mehr
kommen. Weise per API nach, dass ein prettier-PR mit dev
existiert und die Major-PRs geschlossen wurden.
Hinweis: Eine Regel kann enabled: false
auch für einen Update-Typ setzen, und ein fehlendes Label verwirft
Forgejo still.
Lösung
Label zuerst anlegen. Renovate setzt Labels nur beim Anlegen eines
PRs oder wenn sich die konfigurierten Labels ändern. Ein nachträglich
angelegtes Label kommt nicht nach. Die Lösung liegt unter
~/renovate-lab/code/tag02/challenge/renovate.json5.
cd ~/renovate-lab/tag02/shop-api
curl -sf -u "$ADMIN" -H 'Content-Type: application/json' -X POST \
"$FORGEJO/api/v1/repos/shop/shop-api/labels" \
-d '{"name":"dev","color":"#fbca04"}' | jq -r .name
cat > renovate.json5 <<'EOF'
{
$schema: "https://docs.renovatebot.com/renovate-schema.json",
extends: ["config:recommended", ":configMigration"],
prHourlyLimit: 0, // Lab: alle PRs in einem Lauf (Details: Tag 4)
packageRules: [
{
description: "Manager: alle npm-Updates",
matchManagers: ["npm"],
labels: ["npm"],
},
{
description: "exakter Name: express bekommt zusätzlich web",
matchPackageNames: ["express"],
addLabels: ["web"],
},
{
description: "Glob: alle Actions der Org actions",
matchPackageNames: ["actions/*"],
labels: ["ci"],
},
{
description: "Regex + Datei + Datasource: Basis-Image im Dockerfile",
matchFileNames: ["Dockerfile"],
matchDatasources: ["docker"],
matchPackageNames: ["/^node$/"],
labels: ["docker"],
},
{
description: "devDependencies: zusätzlich Label dev",
matchDepTypes: ["devDependencies"],
addLabels: ["dev"],
},
{
description: "Majors: vorerst keine (steht hinten, gewinnt immer)",
matchUpdateTypes: ["major"],
enabled: false,
},
],
}
EOF
renovate-config-validator --strict >/dev/null 2>&1 && git commit -qam "Challenge" \
&& git push -q
renovate shop/shop-api 2>&1 | grep -cE "Autoclosing PR"
curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/pulls?state=all&limit=20" \
| jq -r '.[] | "#\(.number) \(.state) [\([.labels[].name]|join(","))] \(.title)"'Erwartet:
dev
4
#9 open [dev,npm] Update dependency prettier to v3.9.10
#8 closed [] Migrate Renovate config - autoclosed
#6 closed [ci,major] Update dependency node to v24 - autoclosed
#5 closed [major,web] Update dependency express to v5 - autoclosed
#4 closed [ci] Update actions/setup-node action to v7 - autoclosed
#3 closed [ci] Update actions/checkout action to v7 - autoclosed
#2 open [docker] Update Node.js to v20.20.2
#1 open [npm,web] Update dependency express to v4.22.3
Renovate schließt PRs, deren Update nicht mehr gewollt ist, mit dem Zusatz „autoclosed” und löscht den Branch. Wird ein Major später wieder erlaubt, öffnet es einen neuen PR.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Lass
renovate-config-validator --strictin der CI jedes Repos laufen, das eine Renovate-Config enthält. Preset-Tippfehler fängt nur ein Lauf mit--platform=local. - Lege Konventionen fest: ein Ablageort (meist
renovate.json5oder.github/renovate.json5), Kommentare unddescriptionfür jede Regel. - Labels zentral als Org-Labels anlegen, sonst verliert Forgejo/Gitea sie still. GitHub und GitLab legen fehlende Labels dagegen selbst an.
- Pinne die Renovate-Version im Betrieb. Neue Versionen migrieren
Optionen, und
config:recommendedändert seinen Inhalt mit jedem Release. - Wiederkehrende Regeln gehören in ein Org-Preset (Tag 11), nicht kopiert in jedes Repo.