Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 4: Gruppieren, Planen, Begrenzen

Ziel: Du bändigst eine PR-Flut mit Gruppen, Zeitfenstern, Limits und einer Mindest-Reifezeit für neue Releases. · Dauer: ca. 120 min · Voraussetzung: Tag 2

Briefing

  • Ein PR entsteht pro Branchname. Gleicher Branchname heißt gleicher PR – genau das macht groupName.
  • schedule (+ timezone) regelt, wann neue Branches entstehen. Bestehende PRs aktualisiert Renovate auch außerhalb des Fensters.
  • prHourlyLimit, prConcurrentLimit und branchConcurrentLimit deckeln die Menge.
  • minimumReleaseAge lässt neue Releases erst reifen und setzt den Status-Check renovate/stability-days.
  • Was gerade nicht darf, steht im Dependency Dashboard: „Awaiting Schedule”, „Rate-Limited”, „Pending Status Checks”.
Update gefunden ─► Branchname (groupName?) ─► Limit frei? ─► im Schedule? ─► reif?
                                                  │ nein         │ nein        │ nein
                                                  ▼              ▼             ▼
                                            Rate-Limited  Awaiting Schedule  Pending

Drill 1: Die PR-Flut

Frischer Stand: shop-api neu anlegen, lokal klonen und Kurzbefehle für den Tag laden. Die GitHub-Actions-Updates siehst du nur mit gesetztem RENOVATE_GITHUB_COM_TOKEN (Tag 0).

source ~/renovate-lab/setup/env.sh && ~/renovate-lab/setup/check.sh
~/renovate-lab/setup/seed.sh --reset
mkdir -p ~/renovate-lab/tag04 && cd ~/renovate-lab/tag04
cp ~/renovate-lab/code/tag04/helpers.sh .
source helpers.sh
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]

Erwartet (gekürzt):

✔ Repo shop/shop-api vorhanden (sonst: seed.sh)
✔ Bot darf in shop/shop-api schreiben
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator

helpers.sh liefert prs (offene PRs), pkgs (Pakete eines PRs), checks (Renovate-Status-Checks), dash (Dashboard-Text) und ship (validieren, committen, pushen). Jetzt alle Bremsen lösen:

cat > renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended"],
  "prHourlyLimit": 0,
  "prConcurrentLimit": 0
}
EOF
ship "Renovate ohne Limits"
renovate shop/shop-api | grep "PR created"
prs

Erwartet:

✔ Renovate ohne Limits
 INFO: PR created (repository=shop/shop-api, branch=renovate/express-4.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/prettier-3.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/node-20.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/actions-checkout-7.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/actions-setup-node-7.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/express-5.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/node-24.x)
#7 renovate/node-24.x  Update dependency node to v24
#6 renovate/express-5.x  Update dependency express to v5
#5 renovate/actions-setup-node-7.x  Update actions/setup-node action to v7
#4 renovate/actions-checkout-7.x  Update actions/checkout action to v7
#3 renovate/node-20.x  Update Node.js to v20.20.2
#2 renovate/prettier-3.x  Update dependency prettier to v3.9.10
#1 renovate/express-4.x  Update dependency express to v4.22.3

Sieben PRs plus Dashboard für ein Repo mit sechs Abhängigkeiten. Hochgerechnet auf ein echtes Repo mit 80 Abhängigkeiten will das niemand reviewen. Die Zielversionen sind bei dir neuer – das Muster bleibt gleich.

Welche Dateien ändert PR #7?

curl -s -u "$ADMIN" "$R/pulls/7/files" | jq -r '.[].filename'

Erwartet:

.github/workflows/ci.yml
Dockerfile

Zwei Abhängigkeiten heißen node (Docker-Image und node-version in setup-node). Beide Major-Updates ergeben den Branch renovate/node-24.x – und landen deshalb im selben PR. Das ist Gruppierung in ihrer einfachsten Form.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Gruppen mit groupName

Zwei Regeln: alle GitHub Actions in einen PR, alle npm-Minor- und Patch-Updates in einen anderen.

cat > renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended"],
  "prHourlyLimit": 0,
  "prConcurrentLimit": 0,
  "packageRules": [
    {
      "description": "Alle GitHub Actions in einen PR",
      "matchManagers": ["github-actions"],
      "groupName": "GitHub Actions"
    },
    {
      "description": "npm: Minor und Patch zusammen",
      "matchManagers": ["npm"],
      "matchUpdateTypes": ["minor", "patch"],
      "groupName": "npm non-major"
    }
  ]
}
EOF
ship "Gruppen per groupName"
renovate shop/shop-api | grep -E "PR created|PR updated|Autoclosing"
prs
pkgs major-github-actions

Erwartet:

✔ Gruppen per groupName
 INFO: PR created (repository=shop/shop-api, branch=renovate/npm-non-major)
 INFO: PR created (repository=shop/shop-api, branch=renovate/major-github-actions)
 INFO: PR updated (repository=shop/shop-api, branch=renovate/node-24.x)
 INFO: Autoclosing PR (repository=shop/shop-api)
 INFO: Autoclosing PR (repository=shop/shop-api)
 INFO: Autoclosing PR (repository=shop/shop-api)
 INFO: Autoclosing PR (repository=shop/shop-api)
#10 renovate/major-github-actions  Update GitHub Actions (major)
#9 renovate/npm-non-major  Update npm non-major
#7 renovate/node-24.x  Update Node.js to v24
#6 renovate/express-5.x  Update dependency express to v5
#3 renovate/node-20.x  Update Node.js to v20.20.2
actions/checkout: v3 -> v7
actions/setup-node: v3 -> v7
node: 20 -> 24

Drei Dinge fallen auf:

  • Der Branchname kommt aus groupName (klein, Bindestriche) und heißt renovate/npm-non-major.
  • Die Actions-Gruppe heißt major-github-actions. Wegen separateMajorMinor: true (Default) bekommt eine Gruppe für Major-Updates einen eigenen Branch mit major-.
  • Die vier Einzel-PRs, die jetzt in Gruppen stecken, schließt Renovate selbst und löscht ihre Branches. Ihr Titel endet auf „- autoclosed”.

Achtung: Ein vom Menschen geschlossener PR bedeutet „ignorieren” (Tag 1). Ein „autoclosed”-PR dagegen ist harmlos: Renovate hat ihn ersetzt.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Gruppen-Presets

Für Standardfälle gibt es fertige Presets. Schau hinein, statt zu raten:

P=~/renovate-lab/tools/node_modules/renovate/dist/config/presets/internal
node -e 'const g = require(process.argv[1]).presets;
console.log(JSON.stringify(g.allNonMajor.packageRules[0]));
console.log("group:recommended:", g.recommended.extends.length,
  "group:monorepos:", g.monorepos.extends.length);' "$P/group.preset.js"

Erwartet:

{"groupName":"all non-major dependencies","groupSlug":"all-minor-patch",
"matchPackageNames":["*"],"matchUpdateTypes":["minor","patch"]}
group:recommended: 55 group:monorepos: 468
  • group:allNonMajor gruppiert alle Minor- und Patch-Updates, über alle Manager. groupSlug überschreibt den Branchnamen.
  • group:monorepos (468 Gruppen) und group:recommended (55 Gruppen) stecken bereits in config:recommended. Pakete aus einem Monorepo wie @vitest/* kommen so automatisch in einen PR.

Ersetze die npm-Regel durch das Preset:

cat > renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended", "group:allNonMajor"],
  "prHourlyLimit": 0,
  "prConcurrentLimit": 0,
  "packageRules": [
    {
      "description": "Alle GitHub Actions in einen PR",
      "matchManagers": ["github-actions"],
      "groupName": "GitHub Actions"
    }
  ]
}
EOF
ship "Gruppen per Preset"
renovate shop/shop-api | grep -E "PR created|Autoclosing"
prs
pkgs all-minor-patch

Erwartet:

✔ Gruppen per Preset
 INFO: PR created (repository=shop/shop-api, branch=renovate/all-minor-patch)
 INFO: Autoclosing PR (repository=shop/shop-api)
 INFO: Autoclosing PR (repository=shop/shop-api)
#11 renovate/all-minor-patch  Update all non-major dependencies
#10 renovate/major-github-actions  Update GitHub Actions (major)
#7 renovate/node-24.x  Update Node.js to v24
#6 renovate/express-5.x  Update dependency express to v5
express: 4.18.2 -> 4.22.3
node: 20.11.0-alpine -> 20.20.2-alpine
prettier: 3.0.0 -> 3.9.10

Das Docker-Image node steckt jetzt mit drin – das Preset fragt nicht nach dem Manager. Von sieben PRs sind vier übrig: ein Sammel-PR für Kleinkram, je ein PR pro Major.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Majors und Patches trennen

Drei Schalter steuern, wie fein Renovate Updates eines Pakets aufteilt:

Option Default Wirkung bei true
separateMajorMinor true Major getrennt von Minor/Patch
separateMultipleMajor false jeder Major-Sprung eigener PR (v4, v5, v6 …)
separateMinorPatch false Patch getrennt von Minor

Probiere die beiden Nicht-Defaults aus:

jq '. + {"separateMultipleMajor": true, "separateMinorPatch": true}' renovate.json \
  > tmp.json && mv tmp.json renovate.json
ship "Majors und Patches trennen"
renovate shop/shop-api | grep -c "PR created"
prs
pkgs patch-all-minor-patch
pkgs major-5-github-actions

Erwartet:

✔ Majors und Patches trennen
8
#19 renovate/node-22.x  Update Node.js to v22
#18 renovate/major-7-github-actions  Update GitHub Actions to v7
#17 renovate/major-6-github-actions  Update GitHub Actions to v6
#16 renovate/major-5-github-actions  Update GitHub Actions to v5
#15 renovate/major-4-github-actions  Update GitHub Actions to v4
#14 renovate/major-24-github-actions  Update dependency node to v24
#13 renovate/major-22-github-actions  Update dependency node to v22
#12 renovate/patch-all-minor-patch  Update all non-major dependencies (patch)
#11 renovate/all-minor-patch  Update all non-major dependencies (minor)
#7 renovate/node-24.x  Update Node.js to v24
#6 renovate/express-5.x  Update dependency express to v5
express: 4.18.2 -> 4.18.3
node: 20.11.0-alpine -> 20.11.1-alpine
prettier: 3.0.0 -> 3.0.3
actions/checkout: v3 -> v5
actions/setup-node: v3 -> v5

Elf PRs – die Flut ist zurück. Gruppen bekommen die Präfixe patch- und major-<Version>-. separateMultipleMajor lohnt sich nur, wenn du bewusst schrittweise migrieren willst, etwa über mehrere Node-LTS-Versionen. separateMinorPatch ist sinnvoll, wenn Patches automatisch gemergt werden sollen (Tag 5), Minors aber nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Limits

Für Limits brauchst du viele Einzel-Updates und eine leere Stundenbilanz. Also: Repo zurücksetzen, ohne Gruppen.

cd ~/renovate-lab/tag04
~/renovate-lab/setup/seed.sh --reset
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"],
  "prHourlyLimit": 2,
  "prConcurrentLimit": 3
}
EOF
ship "Limits setzen"
renovate shop/shop-api | grep "PR created"
dash | grep -oE 'unlimit-branch=[^ ]+|create-all-rate-limited-prs'

Erwartet (gekürzt):

✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
✔ Limits setzen
 INFO: PR created (repository=shop/shop-api, branch=renovate/express-4.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/prettier-3.x)
unlimit-branch=renovate/node-20.x
unlimit-branch=renovate/actions-checkout-7.x
unlimit-branch=renovate/actions-setup-node-7.x
unlimit-branch=renovate/express-5.x
unlimit-branch=renovate/node-24.x
create-all-rate-limited-prs

Zwei PRs pro Stunde. Ein zweiter Lauf in derselben Stunde bringt nichts – das Debug-Log sagt warum:

LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -oE "Hourly PRs limit reached|Open PR Count.*Hourly PR Count: [0-9]+" \
  ../debug.log | sort | uniq -c

Erwartet:

   5 Hourly PRs limit reached
   7 Open PR Count: 2, Existing Branch Count: 2, Hourly PR Count: 2

prHourlyLimit zählt PRs, die seit Beginn der laufenden Stunde erstellt wurden. Jetzt nur noch die Gesamtzahl begrenzen:

jq '.prHourlyLimit = 0' renovate.json > tmp.json && mv tmp.json renovate.json
ship "Kein Stundenlimit"
LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -oE "INFO: PR created|[A-Za-z]+ limit reached" ../debug.log | sort | uniq -c

Erwartet:

✔ Kein Stundenlimit
   4 Branches limit reached
   1 INFO: PR created

Drei PRs, dann „Branches limit reached” – nicht „PRs”. branchConcurrentLimit ist standardmäßig leer und erbt dann den Wert von prConcurrentLimit. Erlaube mehr Branches als PRs:

jq '.branchConcurrentLimit = 5' renovate.json > tmp.json && mv tmp.json renovate.json
ship "Mehr Branches als PRs"
LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -oE "INFO: Branch created|[A-Za-z]+ limit reached" ../debug.log | sort | uniq -c
prs

Erwartet:

✔ Mehr Branches als PRs
   2 Branches limit reached
   2 ConcurrentPRs limit reached
   2 INFO: Branch created
#4 renovate/node-20.x  Update Node.js to v20.20.2
#2 renovate/prettier-3.x  Update dependency prettier to v3.9.10
#1 renovate/express-4.x  Update dependency express to v4.22.3

Fünf Branches, drei PRs. Die zwei PR-losen Branches stehen weiter unter „Rate-Limited” und bekommen ihren PR, sobald einer der drei gemergt ist. Nützlich mit Branch-Automerge (Tag 5): Der Branch läuft schon durch die CI, ohne Review-Last zu erzeugen. Wer nicht warten will, hakt im Dashboard unlimit-branch an – die Checkboxen umgehen alle Limits, auch prHourlyLimit (Tag 14).

Option Default zählt
prHourlyLimit 2 PRs, die in der laufenden Stunde erstellt wurden
prConcurrentLimit 10 offene Renovate-PRs
branchConcurrentLimit leer (= PR-Limit) existierende Renovate-Branches
commitHourlyLimit 0 Commits pro Stunde (0 = kein Limit)

Fortschritt speichern? Kostenlos registrieren

Drill 6: Zeitfenster mit schedule

Renovate prüft bei jedem Lauf, ob „jetzt” im Fenster liegt. Ohne timezone gilt UTC. Unser Fenster: montags 0 bis 5:59 Uhr Berliner Zeit. Machst du den Drill gerade montags früh, nimm Dienstag (* 0-5 * * 2).

cat > renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended"],
  "prHourlyLimit": 0,
  "prConcurrentLimit": 0,
  "timezone": "Europe/Berlin",
  "schedule": ["* 0-5 * * 1"]
}
EOF
ship "Nur montags frueh"
LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -E "Human-readable|Checking schedule\(" ../debug.log | head -2 | cut -c1-88
grep -oE "Skipping (PR|branch) creation[a-z ]*[a-z]|will update if necessary" \
  ../debug.log | sort | uniq -c

Erwartet (gekürzt):

DEBUG: Checking schedule(schedule=* 0-5 * * 1, tz=Europe/Berlin, now=2026-10-12T16:11:27
DEBUG: Human-readable summary for cron:: Every minute, between 12:00 AM and 05:59 AM, on
   2 Skipping branch creation as not within schedule
   2 Skipping PR creation out of schedule
   3 will update if necessary

Drei Fälle: Bestehende PRs bleiben gepflegt, Branches ohne PR bekommen keinen, neue Branches entstehen nicht. Im Dashboard:

dash | grep -oE 'unschedule-branch=[^ ]+'

Erwartet:

unschedule-branch=renovate/actions-checkout-7.x
unschedule-branch=renovate/actions-setup-node-7.x
unschedule-branch=renovate/express-5.x
unschedule-branch=renovate/node-24.x

Belege „will update if necessary”: Ändere auf main die Zeile, die PR #4 anfasst. Der Branch hat dann einen Konflikt und muss neu gebaut werden.

sed -i.bak 's/node:20.11.0-alpine/node:20.12.0-alpine/' Dockerfile && rm Dockerfile.bak
ship "Node 20.12 von Hand"
LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -E "INFO: (Branch|PR)|Branch is conflicted" ../debug.log | cut -c1-88
pkgs node-20.x

Erwartet:

✔ Node 20.12 von Hand
DEBUG: Branch is conflicted (repository=shop/shop-api, branch=renovate/node-20.x)
 INFO: Branch updated (repository=shop/shop-api, branch=renovate/node-20.x)
 INFO: PR updated (repository=shop/shop-api, branch=renovate/node-20.x)
node: 20.12.0-alpine -> 20.20.2-alpine

Außerhalb des Fensters, trotzdem aktualisiert. Soll Renovate dann wirklich die Finger stillhalten, setze updateNotScheduled: false (Preset :noUnscheduledUpdates):

jq '.updateNotScheduled = false' renovate.json > tmp.json && mv tmp.json renovate.json
sed -i.bak 's/node:20.12.0-alpine/node:20.13.0-alpine/' Dockerfile && rm Dockerfile.bak
ship "Ausserhalb des Fensters nichts anfassen"
LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -oE "INFO: (Branch|PR) updated|Skipping branch update[a-z ]*[a-z]" ../debug.log \
  | sort | uniq -c
pkgs node-20.x

Erwartet:

✔ Ausserhalb des Fensters nichts anfassen
   5 Skipping branch update as not within schedule
node: 20.12.0-alpine -> 20.20.2-alpine

PR #4 bleibt veraltet und im Konflikt, bis das Fenster aufgeht. Für die meisten Teams ist der Default (true) die bessere Wahl.

Zur Syntax: Renovate 44 nimmt Cron (empfohlen) und noch die alte Textform. Fertige Fenster liefern die schedule:*-Presets.

cd ~/renovate-lab/tag04
node -e 'const s = require(process.argv[1]).presets;
for (const k of ["weekly", "earlyMondays", "nonOfficeHours"])
  console.log(k, JSON.stringify(s[k].schedule ?? s[k].extends));' \
  "$P/schedule.preset.js"
for s in "before 6am on monday" "before 6am on mondai" "0 0-5 * * 1"; do
  echo "{\"schedule\": [\"$s\"]}" > s.json
  renovate-config-validator --no-global s.json 2>&1 | grep -E "success|message"
done
rm s.json; cd shop-api

Erwartet (gekürzt):

weekly ["schedule:earlyMondays"]
earlyMondays ["* 0-3 * * 1"]
nonOfficeHours ["* 0-4,22-23 * * 1-5","* * * * 0,6"]
 INFO: Config validated successfully against 1 file(s)
           "message": "Invalid schedule: `Invalid schedule: Failed to parse \"before
           "message": "Invalid schedule: `Invalid schedule: \"0 0-5 * * 1\" has cron

Achtung: Die Minute muss * sein. Renovate läuft nicht minutengenau; 0 0-5 * * 1 würde fast nie treffen und wird deshalb abgelehnt. Ein Tippfehler in der Textform fällt nur dem Validator auf – Cron ist robuster.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Reifezeit mit minimumReleaseAge

Ganz frische Releases sind öfter kaputt oder sogar bösartig (Tag 12). minimumReleaseAge wartet, bis ein Release alt genug ist. Schedule raus, Gruppe rein:

cat > renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended", "group:allNonMajor"],
  "prHourlyLimit": 0,
  "prConcurrentLimit": 0,
  "minimumReleaseAge": "3 days"
}
EOF
ship "Neue Releases 3 Tage reifen lassen"
renovate shop/shop-api > /dev/null
pkgs all-minor-patch
checks all-minor-patch
npm view prettier time --json | jq -r '."3.9.9", ."3.9.10"'

Erwartet:

✔ Neue Releases 3 Tage reifen lassen
express: 4.18.2 -> 4.22.3
prettier: 3.0.0 -> 3.9.9
renovate/stability-days: success – Updates have met minimum release age requirement
2026-09-23T06:31:34.693Z
2026-10-10T08:35:28.472Z

Am Testtag war prettier 3.9.10 erst zwei Tage alt. Renovate nimmt deshalb die neueste reife Version 3.9.9 (internalChecksFilter: "strict", Default) und setzt den Status-Check renovate/stability-days auf grün. Bei dir trifft es andere Pakete.

Und wo ist das Docker-Image node? Es fehlt in der Gruppe:

LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep -A3 "as pending" ../debug.log | cut -c1-88 | head -4

Erwartet:

DEBUG: Marking 20 release(s) as pending, as they do not have a releaseTimestamp and we'r
       "depName": "node",
       "versions": [
         "20.20.2",

Achtung: Die Docker-Datasource lieferte im Lab für node keine Veröffentlichungszeit. Mit dem Default minimumReleaseAgeBehaviour: "timestamp-required" gilt so ein Update als nie reif und verschwindet still aus der Gruppe. Drill 8 macht das sichtbar.

Fortschritt speichern? Kostenlos registrieren

Drill 8: Pending sichtbar machen

Erst die Gegenprobe: Mit internalChecksFilter: "none" nimmt Renovate die neueste Version sofort und meldet die fehlende Reife nur per Status-Check.

jq '.internalChecksFilter = "none"' renovate.json > tmp.json \
  && mv tmp.json renovate.json
ship "Neueste Version sofort"
renovate shop/shop-api | grep -E "WARN|PR updated" | cut -c1-88
pkgs all-minor-patch
checks all-minor-patch

Erwartet:

✔ Neueste Version sofort
 WARN: npm `--before` could not be enforced because existing locked packages were publis
 INFO: PR updated (repository=shop/shop-api, branch=renovate/all-minor-patch)
 INFO: PR updated (repository=shop/shop-api, branch=renovate/node-24.x)
express: 4.18.2 -> 4.22.3
node: 20.13.0-alpine -> 20.20.2-alpine
prettier: 3.0.0 -> 3.9.10
renovate/stability-days: pending – Updates have not met minimum release age requirement

Der Status steht auf pending. Ist er als Pflicht-Check im Branch-Schutz eingetragen, blockiert er den Merge, bis die Reifezeit vorbei ist – Renovate setzt ihn bei einem späteren Lauf auf success. Zurück zu strict, Docker-Images in eine eigene Gruppe:

cat > renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended", "group:allNonMajor"],
  "prHourlyLimit": 0,
  "prConcurrentLimit": 0,
  "minimumReleaseAge": "3 days",
  "packageRules": [
    {
      "matchDatasources": ["docker"],
      "groupName": "Docker-Images"
    }
  ]
}
EOF
ship "Docker-Images eigene Gruppe"
LOG_LEVEL=debug renovate shop/shop-api > ../debug.log 2>&1
grep "internalChecksFilter was not met" ../debug.log | cut -c8-88
dash | grep -oE 'unpend-branch=[^ ]+'

Erwartet:

✔ Docker-Images eigene Gruppe
Branch renovate/docker-images creation is disabled because internalChecksFilter w
Branch renovate/major-docker-images creation is disabled because internalChecksFi
unpend-branch=renovate/docker-images
unpend-branch=renovate/major-docker-images

Jetzt steht die Lücke im Dashboard. Vertraust du der Registry ohne Zeitstempel, erlaube die Updates gezielt für Docker:

jq '.packageRules[0].minimumReleaseAgeBehaviour = "timestamp-optional"' renovate.json \
  > tmp.json && mv tmp.json renovate.json
ship "Docker ohne Zeitstempel erlauben"
renovate shop/shop-api | grep -E "WARN|PR created" | cut -c1-88

Erwartet:

✔ Docker ohne Zeitstempel erlauben
 WARN: Some release(s) did not have a releaseTimestamp, but as we're running with minimu
 WARN: Some upgrade(s) did not have a releaseTimestamp, but as we're running with minimu
 INFO: PR created (repository=shop/shop-api, branch=renovate/docker-images)
 INFO: PR created (repository=shop/shop-api, branch=renovate/major-docker-images)

Die Abschnitte des Dashboards im Überblick:

Abschnitt Ursache Checkbox erzwingt
Awaiting Schedule außerhalb von schedule unschedule-branch
Rate-Limited prHourlyLimit, prConcurrentLimit, branchConcurrentLimit unlimit-branch
Pending Status Checks minimumReleaseAge nicht erfüllt unpend-branch
Pending Approval dependencyDashboardApproval (Tag 14) approve-branch

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

cd ~/renovate-lab/tag04/shop-api && source ../helpers.sh
renovate-config-validator --no-global renovate.json >/dev/null 2>&1 \
  && echo "✔ renovate.json gültig" || echo "✘ renovate.json ungültig"
jq -e '.extends | index("group:allNonMajor")' renovate.json >/dev/null \
  && echo "✔ group:allNonMajor aktiv" || echo "✘ group:allNonMajor fehlt"
jq -e '.minimumReleaseAge == "3 days"' renovate.json >/dev/null \
  && echo "✔ minimumReleaseAge gesetzt" || echo "✘ minimumReleaseAge fehlt"
prs | grep -q "renovate/all-minor-patch" \
  && echo "✔ Sammel-PR offen" || echo "✘ kein Sammel-PR"
checks all-minor-patch | grep -q "stability-days: success" \
  && echo "✔ stability-days grün" || echo "✘ stability-days nicht grün"
prs | grep -q "renovate/docker-images" \
  && echo "✔ Docker-Gruppe offen" || echo "✘ Docker-Gruppe fehlt"

Erwartet:

✔ renovate.json gültig
✔ group:allNonMajor aktiv
✔ minimumReleaseAge gesetzt
✔ Sammel-PR offen
✔ stability-days grün
✔ Docker-Gruppe offen

Challenge

Baue einen Wochenplan für ein frisches shop-api: Alle Minor- und Patch-Updates kommen gesammelt, aber nur montags vor 6 Uhr Berliner Zeit. Majors kommen einzeln und jederzeit. Es sind nie mehr als drei Renovate-PRs offen.

Hinweis: schedule funktioniert auch innerhalb einer packageRule.

Lösung

cd ~/renovate-lab/tag04
~/renovate-lab/setup/seed.sh --reset
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", "group:allNonMajor"],
  "timezone": "Europe/Berlin",
  "prHourlyLimit": 0,
  "prConcurrentLimit": 3,
  "packageRules": [
    {
      "description": "Non-Major nur montags vor 6 Uhr",
      "matchUpdateTypes": ["minor", "patch"],
      "schedule": ["* 0-5 * * 1"]
    }
  ]
}
EOF
ship "Wochenplan"
renovate shop/shop-api | grep "PR created"
dash | grep -oE '^## [A-Za-z -]+|(unschedule|unlimit)-branch=[^ ]+'

Erwartet (außerhalb des Montagsfensters):

✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
✔ Wochenplan
 INFO: PR created (repository=shop/shop-api, branch=renovate/actions-checkout-7.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/actions-setup-node-7.x)
 INFO: PR created (repository=shop/shop-api, branch=renovate/express-5.x)
## Awaiting Schedule
unschedule-branch=renovate/all-minor-patch
## Rate-Limited
unlimit-branch=renovate/node-24.x
## Open
## Detected Dependencies

Majors sind einzeln da, der Sammel-PR wartet auf Montag, das vierte Major steht wegen des Limits an. Separate Majors sind Default (separateMajorMinor: true); dafür brauchst du nichts zu tun. Montags früh wird der Sammel-PR trotzdem nur angelegt, wenn unter den drei Plätzen einer frei ist – Schedule und Limit wirken zusammen.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Lege Gruppen, Fenster und Limits zentral als Org-Preset fest (Tag 11). Teams überschreiben nur, wenn sie einen Grund haben.
  • Plane das Schedule-Fenster passend zum Renovate-Takt (Tag 10). Ein stündlicher CronJob braucht ein Fenster von mindestens einer Stunde, sonst trifft er es nie.
  • prConcurrentLimit deckelt pro Repo, nicht pro Organisation. Für die CI-Last zählt die Summe über alle Repos.
  • minimumReleaseAge ist eine Supply-Chain-Maßnahme (Tag 12). Lege fest, welche Datasources keine Zeitstempel liefern und wie damit umgegangen wird.
  • Sicherheits-Updates (vulnerabilityAlerts) ignorieren Schedule und Limits standardmäßig. Das ist gewollt, aber im Change-Management zu erklären.