Zum Inhalt springen
Trainingslager IT-Trainingslager

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.
  • extends lädt Presets von links nach rechts. Spätere überschreiben frühere, eigene Schlüssel in der Datei überschreiben alle Presets.
  • packageRules werden 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 --oneline

Erwartet (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

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 -t2

Erwartet:

  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.json

Erwartet:

{"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-api scheitert 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.json

Erwartet:

{"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
done

Erwartet:

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 prio

Erwartet:

 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.json und .gitlab/renovate.json gelten auf jeder Plattform, auch auf Forgejo. .forgejo/renovate.json dagegen liest 44.153.1 nicht, auch nicht mit RENOVATE_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-test

Erwartet:

       "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 -3

Erwartet (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 (addLabels addiert web).
  • #5 passt zusätzlich auf Regel 5. labels ist nicht mergebar, major ersetzt npm. addLabels ist mergebar, web bleibt.
  • #3/#4 bleiben ci, weil die Negation !actions/* sie aus Regel 5 nimmt.
  • #6 bündelt node im Dockerfile und node-version in ci.yml (gleicher Branch renovate/node-24.x). Labels aller Updates im Branch werden vereinigt. Woher kommt ci? Der Matcher prüft den packageName, 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 die ci.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. semanticCommits steht auf auto: Überwiegen in den letzten Commits auf main Meldungen im Muster typ: text, schreibt Renovate fix(deps): update … für dependencies und chore(deps): … für alles andere. Das ist :semanticPrefixFixDepsChoreOthers aus Drill 2. Live beobachtet, schon Meldungen wie Renovate: neue Regel zä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 --strict in 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.json5 oder .github/renovate.json5), Kommentare und description fü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.