Tag 15: Wettkampf – Desaster-Drills
Ziel: Du findest und behebst unter Zeitdruck acht typische Renovate-Störungen, von der kaputten Config bis zum Lockfile, das an einer Peer-Dependency scheitert. · Dauer: ca. 120 min · Voraussetzung: Tag 14
Briefing
- Jede Runde hat ein eigenes Repo in der Org
shop.aufstellung.shbaut alle Startzustände auf einmal, inklusive „Nachtlauf” von Renovate. - Pro Runde: Lagebild aufnehmen, Stoppuhr starten, reparieren, bis
wk-check.shdie Runde mit ✔ meldet. Erst messen (Log, Dashboard, API), dann ändern. - Der Hinweis kostet die Hälfte der Punkte. Die Lösung liest du erst danach.
- Keine Abkürzungen über Admin-Rechte: Renovate muss den Zustand selbst herstellen.
Störung ──► Lagebild (Issue, Dashboard, PR, Log) ──► Diagnose ──► kleinste Reparatur
└──► Renovate-Lauf ──► wk-check ✔
Drill 0: Aufstellung (ohne Zeit)
Der Begleitcode bringt drei Skripte und unter repos/ die
Dateien der sieben Wettkampf-Repos mit. wk.sh liefert die
Helfer aus den Vortagen, jetzt mit dem Repo-Namen als erstem Argument:
prs, issues, body,
dash, dashnr, tick,
checks, ci, klon und
ship.
source ~/renovate-lab/setup/env.sh && ~/renovate-lab/setup/check.sh
export RENOVATE_GITHUB_COM_TOKEN=$(gh auth token) # optional, siehe Tag 0
mkdir -p ~/renovate-lab/tag15 && cd ~/renovate-lab/tag15
cp ~/renovate-lab/code/tag15/{aufstellung.sh,wk-check.sh,wk.sh} .
./aufstellung.sh && ./wk-check.sh
source wk.shErwartet (gekürzt):
✔ Bot darf in shop/shop-api schreiben
✔ shop/kasse (Actions: false)
✔ shop/automat (Actions: true)
… Nachtlauf (1–3 min)
1 "result": "config-validation",
7 "result": "done",
✔ Aufstellung fertig – weiter mit ./wk-check.sh
✘ R1 kasse: Config gültig, kein Action-Required-Issue, PRs offen
✘ R2 wk-token: gültig, Scopes reichen, kein Admin-Scope
✘ R3 werkzeug: Makefile-Werkzeuge im Dashboard
✘ R4 automat: prettier-PR gemergt, Actions aus, ci/test ist Pflicht
✘ R5 flut: höchstens 6 PRs offen, Sammel-PR da, Altlast autoclosed
✘ R6 major: express-Major-PR wieder offen
✘ R7 bezahlung: Lookup klappt, PR für @shop/money offen
✘ R8 lager (Bonus): offene PRs ohne Artefakt-Fehler
Gelöst: 0 von 8
Das Skript legt per mkrepo.sh (Tag 0) sieben Repos an,
veröffentlicht @shop/money wie an Tag 8 mit einem
kurzlebigen Admin-Token und lässt Renovate einmal über alles laufen
(nacht.log). Was es im Einzelnen tut, zeigt
grep '^# [0-9]' aufstellung.sh. Du kannst es jederzeit
erneut starten, die Repos werden dann frisch angelegt.
Alles rot, so soll es sein. Die Zahlen und Zielversionen in diesem
Kapitel stammen aus dem Testlauf, bei dir sind die Versionen neuer. Ohne
RENOVATE_GITHUB_COM_TOKEN fehlen in kasse die
GitHub-Actions-Updates, sonst ändert sich nichts.
Achtung: Spiel die Runden in der Reihenfolge 1 bis 8. Runde 2 nutzt
shop/kassefür die Probe, und jede Runde endet mit einem echten Renovate-Lauf.
Fortschritt speichern? Kostenlos registrieren
Runde 1: Ein Komma fehlt
Lagebild: Seit gestern kommt aus
shop/kasse kein einziger PR mehr. Dafür liegt ein Issue im
Repo.
issues kasse; prs kasse
grep -A4 'invalid config' nacht.log | cut -c1-88Erwartet:
#1 open Action Required: Fix Renovate Configuration
WARN: Repository has invalid config (repository=shop/kasse)
"err": {
"validationSource": "renovate.json",
"validationError": "Invalid JSON (parsing failed)",
"validationMessage": "Syntax error: expecting number near 0\n \"pack",
Auftrag: Renovate legt in kasse wieder
PRs an, das Issue ist geschlossen.
Zeitbudget: 5 min · Punkte: 10
Hinweis: Die Meldung im Issue ist kryptisch;
jq und der Validator nennen Zeile und Spalte.
Lösung:
klon kasse
renovate-config-validator 2>&1 | grep -E 'WARN|"message"'
jq . renovate.json > /dev/null
sed -n 4,5p renovate.jsonErwartet:
WARN: File could not be parsed
"message": "JSON5: invalid character '\\\"' at 5:3"
jq: parse error: Expected separator between values at line 5, column 16
"prHourlyLimit": 0
"packageRules": [
Hinter "prHourlyLimit": 0 fehlt das Komma:
sed -i.bak 's/"prHourlyLimit": 0$/&,/' renovate.json && rm renovate.json.bak
ship "renovate.json: fehlendes Komma"
cd .. && renovate shop/kasse | grep -E 'PR created|"result"'
issues kasse allErwartet:
✔ renovate.json: fehlendes Komma
INFO: PR created (repository=shop/kasse, branch=renovate/express-4.x)
INFO: PR created (repository=shop/kasse, branch=renovate/prettier-3.x)
INFO: PR created (repository=shop/kasse, branch=renovate/node-20.x)
"result": "done",
#5 open Dependency Dashboard
#1 closed Action Required: Fix Renovate Configuration
Renovate schließt das Fehler-Issue selbst. Die Majors fehlen
absichtlich: Die Config verlangt für sie
dependencyDashboardApproval.
Lehre:
- Kaputte Repo-Config heißt: Exit-Code 0,
"result": "config-validation"und ein Issue, aber kein PR (Tag 9). Ohne Blick in Issues oder Logs merkt das niemand. - Renovate liest
renovate.jsontolerant als JSON5: Ein Komma am Listenende ging im Test durch. Den Validator trotzdem als Pflicht-Check in die CI jedes Repos (Tag 2).
Fortschritt speichern? Kostenlos registrieren
Runde 2: Der rotierte Token
Lagebild: Ein Kollege hat den Bot-Token „schon mal
rotiert”. Der neue Token liegt in wk-token und soll morgen
in die Betriebskonfiguration. Du machst die Probe.
RENOVATE_TOKEN=$(cat wk-token) renovate shop/kasse > token.log 2>&1; echo "exit=$?"
grep -E '^FATAL|errorMessage' token.logErwartet:
exit=1
FATAL: Initialization error
"errorMessage": "Authentication failure"
"errorMessage": "Authentication failure",
Auftrag: Finde die Ursache und erzeuge einen Ersatz
in wk-token mit genau den Scopes, die Renovate braucht. Der
kaputte Token wird gelöscht, kein Admin-Scope.
Zeitbudget: 10 min · Punkte: 15
Hinweis: Renovate fragt als Erstes
GET /api/v1/user ab; Forgejo nennt in der Antwort den
fehlenden Scope.
Lösung: Die Antwort von Forgejo ist deutlicher als Renovate.
curl -s -H "Authorization: token $(cat wk-token)" "$FORGEJO/api/v1/user" \
| jq -r .message
curl -s -H "Authorization: token $(cat wk-token)" "$FORGEJO/api/v1/repos/shop/kasse" \
| jq -c .permissions
BOT=renovate-bot:lab-bot-pw-123 # Lab-Wert!
curl -s -u $BOT "$FORGEJO/api/v1/users/renovate-bot/tokens" \
| jq -c '.[] | select(.name == "renovate-rotation") | .scopes'Erwartet:
token does not have at least one of required scope(s): [read:user]
{"admin":false,"push":true,"pull":true}
["read:repository"]
Der Token hat nur read:repository. Vorsicht bei
permissions: push: true ist das Recht des
Benutzers im Repo, nicht das des Tokens. Wer nur
read:user ergänzt, läuft im Test in den nächsten Fehler
(read:organization beim Lesen der Org), danach in
remote: Forbidden beim Push. Also gleich die vollständige
Liste aus Tag 0:
curl -s -o /dev/null -w "%{http_code}\n" -u $BOT -X DELETE \
"$FORGEJO/api/v1/users/renovate-bot/tokens/renovate-rotation"
curl -s -u $BOT -H 'Content-Type: application/json' \
-X POST "$FORGEJO/api/v1/users/renovate-bot/tokens" -d '{"name": "renovate-rotation",
"scopes": ["write:repository", "write:issue", "read:user", "read:organization",
"read:package"]}' | jq -j .sha1 > wk-token
RENOVATE_TOKEN=$(cat wk-token) renovate shop/kasse | grep -E '^FATAL|"result"'Erwartet:
204
"result": "done",
jq -j schreibt den Token ohne Zeilenumbruch (Tag 10).
Der Bot legt ihn selbst per Basic Auth an, Rotation geht also ohne
Admin-Zugang zum Container.
Lehre:
Authentication failureheißt bei Forgejo oft „falscher Scope”, nicht „falscher Token”. Die eigentliche Meldung steht erst im Debug-Log oder in der API-Antwort.- Rotation ist ein Verfahren mit fester Scope-Liste und Probe-Lauf.
read:packagenur, wenn Repos die Forgejo-Registry nutzen (Runde 7).
Fortschritt speichern? Kostenlos registrieren
Runde 3: Der Regex sieht nichts
Lagebild: Das Team pflegt Lint-Werkzeuge im
Makefile von shop/werkzeug und hat dafür einen
Regex-Manager gebaut (Tag 7). Seit Wochen kommt kein Update, im
Dashboard steht nur das Basis-Image.
dash werkzeug | grep -E '^<details><summary>[a-z]|^ - `'
head -5 ~/renovate-lab/code/tag15/repos/werkzeug/MakefileErwartet:
<details><summary>dockerfile (1)</summary>
- `node 20.11.0-alpine` → [Updates: `20.20.2-alpine`, `24.21.0-alpine`]
# Werkzeuge für Doku- und API-Checks (Version hier pflegen, nicht im CI-Job)
# renovate: datasource=npm depName=markdownlint-cli2
MARKDOWNLINT_VERSION ?= 0.10.0
# renovate: datasource=npm depName=@redocly/cli
REDOCLY_VERSION ?= 1.0.0
Auftrag: markdownlint-cli2 und
@redocly/cli erscheinen im Dashboard und bekommen PRs. Das
Makefile bleibt, wie es ist.
Zeitbudget: 10 min · Punkte: 15
Hinweis:
--platform=local --dry-run=extract mit
LOG_LEVEL=debug sagt dir, ob das Dateimuster oder der Regex
scheitert.
Lösung: Erst trennen, welcher Teil des Managers versagt.
klon werkzeug
LOG_LEVEL=debug renovate --platform=local --dry-run=extract > ../extract.log 2>&1
grep -E 'Matched .* manager regex|No dependencies found' ../extract.log | cut -c1-88
jq -r '.customManagers[0].matchStrings[0]' renovate.json | grep -o '\\n.*'Erwartet:
DEBUG: Matched 1 file(s) for manager regex (repository=local)
DEBUG: No dependencies found in file for custom regex manager (repository=local, package
\n\w+_VERSION := (?<currentValue>\S+)
Die Datei wird gefunden, der Regex trifft nicht. Er erwartet
:=, im Makefile steht ?=. Die
Zuweisung soll künftig in allen drei Make-Varianten passen:
jq '.customManagers[0].matchStrings[0] |= sub(" := "; " [:?]?= ")' renovate.json \
> neu.json && mv neu.json renovate.json
renovate --platform=local --dry-run=extract --report-type=file \
--report-path=../extract.json > /dev/null 2>&1
jq -r '.repositories[].packageFiles.regex[].deps[]
| "\(.depName) \(.currentValue) (\(.datasource))"' ../extract.json
ship "Makefile-Regex: ?= statt :="
cd .. && renovate shop/werkzeug | grep -E 'PR created|"result"'
dash werkzeug | grep -E '^ - `'Erwartet:
markdownlint-cli2 0.10.0 (npm)
@redocly/cli 1.0.0 (npm)
✔ Makefile-Regex: ?= statt :=
INFO: PR created (repository=shop/werkzeug, branch=renovate/redocly-cli-1.x)
INFO: PR created (repository=shop/werkzeug, branch=renovate/markdownlint-cli2-0.x)
INFO: PR created (repository=shop/werkzeug, branch=renovate/redocly-cli-2.x)
"result": "done",
- `node 20.11.0-alpine` → [Updates: `20.20.2-alpine`, `24.21.0-alpine`]
- `markdownlint-cli2 0.10.0` → [Updates: `0.23.3`]
- `@redocly/cli 1.0.0` → [Updates: `1.34.20`, `2.62.1`]
Lehre:
- Ein Regex-Manager, der nichts findet, erzeugt keinen Fehler und
keine Warnung. Nur „Detected Dependencies” im Dashboard oder
--dry-run=extractzeigen die Lücke. - Zwei Debug-Zeilen trennen die Fehlerquellen:
Matched N file(s)(Dateimuster) undNo dependencies found in file(Regex). Der lokale Extract braucht keinen Push.
Fortschritt speichern? Kostenlos registrieren
Runde 4: Automerge, der nie kommt
Lagebild: In shop/automat sollen Patch-
und Minor-Updates der devDependencies automatisch landen (Tag 5). Der
prettier-PR ist seit gestern offen.
prs automat
body automat 2 | grep 'Automerge\*\*'
checks automat renovate/prettier-3.xErwartet:
#1 open renovate/express-4.x | Update dependency express to v4.22.3
#2 open renovate/prettier-3.x | Update dependency prettier to v3.9.10
#3 open renovate/express-5.x | Update dependency express to v5
🚦 **Automerge**: Enabled.
gesamt: pending
ci / test (pull_request) = pending (Waiting to run)
ci / test (push) = pending (Waiting to run)
Auftrag: Das Team hat entschieden: Die Tests laufen
ab sofort in der zentralen Lab-CI, die als ci/test meldet
(Helfer ci, wie an Tag 5). Bring PR #2 zum automatischen
Merge, aber erst nach grünem ci/test. Kein
ignoreTests, kein Hand-Merge.
Zeitbudget: 15 min · Punkte: 15
Hinweis: Wer soll ci / test eigentlich
ausführen? Frag die Actions-API nach Läufen und Runnern.
Lösung: Erst die Ursache, dann Renovates Sicht.
api "$(R automat)/actions/runs" \
| jq -r '.workflow_runs[] | "\(.status) \(.event) \(.title)"' | head -3
api "$(R automat)/actions/runners"; echo
LOG_LEVEL=debug renovate shop/automat > automat.log 2>&1
grep 'renovate/prettier' automat.log \
| grep -oE 'Branch status (yellow|green|red)|PR is not ready[^(]*' | sort | uniq -cErwartet:
waiting push Update dependency express to v5
waiting pull_request Update dependency express to v5
waiting push Update dependency prettier to v3.9.10
[]
2 Branch status yellow
1 PR is not ready for merge
Forgejo führt .github/workflows/ci.yml als Actions aus,
aber es gibt keinen Runner. Die Läufe warten ewig, die Checks bleiben
pending, Renovate sieht „yellow” und wartet mit. Die alten
Status hängen am alten Commit, also braucht es nach dem Abschalten einen
Rebase. Vorher kommt die Branch-Protection, sonst gibt es eine böse
Überraschung:
api -X POST "$(R automat)/branch_protections" -d '{"rule_name": "main",
"enable_status_check": true, "status_check_contexts": ["ci/test"]}' \
| jq -c '{rule_name, enable_status_check, status_check_contexts}'
api -X PATCH "$(R automat)" -d '{"has_actions":false}' | jq -c '{has_actions}'
tick automat 2 rebase-check
renovate shop/automat | grep -E '"result"'
sleep 5; prs automat all | grep prettier
checks automat renovate/prettier-3.x
ci automat renovate/prettier-3.x success
sleep 5; prs automat all | grep prettierErwartet:
{"rule_name":"main","enable_status_check":true,"status_check_contexts":["ci/test"]}
{"has_actions":false}
"result": "done",
#2 open renovate/prettier-3.x | Update dependency prettier to v3.9.10
gesamt:
ci/test = success
#2 merged refs/pull/2/head | Update dependency prettier to v3.9.10
Nach dem Rebase hat der neue Commit keinen einzigen Status. Forgejo
wartet jetzt auf den Pflicht-Check und merged erst nach
ci/test = success. Den Merge löst Forgejo selbst aus:
Renovate hatte ihn beim Anlegen des PRs vorgemerkt
(platformAutomerge, Tag 5).
Achtung: Ohne Branch-Protection hat Forgejo im Test eine Sekunde nach dem Rebase-Push gemergt, ganz ohne Test. Ein vorgemerkter Merge feuert, sobald kein Check mehr
pendingist, auch bei null Checks. Renovate selbst hätte gewartet.
Lehre:
- Ein einziger Check, den nie jemand abarbeitet, blockiert jeden
Automerge. Renovate meldet das nur im Debug-Log als
Branch status yellow. - In Produktion heißt die Reparatur: Runner registrieren oder den Workflow entfernen. Actions abschalten ist nur richtig, wenn eine andere CI übernimmt.
platformAutomergeauf Forgejo nur mit Branch-Protection und Pflicht-Checks (Tag 5). Erst sie machen „erst testen, dann mergen” zur Regel.
Fortschritt speichern? Kostenlos registrieren
Runde 5: Die PR-Flut
Lagebild: Jemand wollte in shop/flut
„mal alles sehen” und hat alle Bremsen gelöst. Der Nachtlauf hat das
Repo geflutet.
prs flut | wc -l
prs flut | grep -E 'dotenv' | head -3
api "$(R flut)/raw/renovate.json" | jq 'del(."$schema")'Erwartet:
32
#11 open renovate/dotenv-11.x | Update dependency dotenv to v11
#12 open renovate/dotenv-12.x | Update dependency dotenv to v12
#13 open renovate/dotenv-13.x | Update dependency dotenv to v13
{
"extends": [
"config:recommended"
],
"prHourlyLimit": 0,
"prConcurrentLimit": 0,
"branchConcurrentLimit": 0,
"separateMinorPatch": true,
"separateMultipleMajor": true
}Auftrag: Höchstens fünf offene PRs plus ein Sammel-PR für alle Minor- und Patch-Updates, der heute noch kommt. Neue Majors nur nach Freigabe im Dashboard. Die Altlast räumt Renovate selbst ab, kein PR wird von Hand geschlossen.
Zeitbudget: 15 min · Punkte: 15
Hinweis: Ein von Hand geschlossener PR ist ein Ignore (Runde 6); was Renovate nicht mehr braucht, schließt es selbst als „autoclosed”.
Lösung: Neue Config aus den Bausteinen von Tag 4:
klon flut
cat > renovate.json <<'EOF'
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": ["config:recommended", "group:allNonMajor"],
"prConcurrentLimit": 5,
"packageRules": [
{
"description": "Majors erst nach Freigabe im Dashboard",
"matchUpdateTypes": ["major"],
"dependencyDashboardApproval": true
}
]
}
EOF
ship "Flut eindaemmen: Sammel-PR, Limit, Major-Freigabe"
cd .. && LOG_LEVEL=debug renovate shop/flut > flut.log 2>&1
grep -c 'Autoclosing PR' flut.log
grep -oE 'Hourly PRs limit reached|Open PR Count.*Hourly PR Count: [0-9]+' flut.log \
| sort -u
prs flut
dash flut | sed -n '/^## Pending Approval/,/^## Open/p' | grep -E '^##|^ - ' \
| cut -c1-88Erwartet:
✔ Flut eindaemmen: Sammel-PR, Limit, Major-Freigabe
27
Hourly PRs limit reached
Open PR Count: 5, Existing Branch Count: 5, Hourly PR Count: 32
#10 open renovate/axios-1.x | Update dependency axios to v1
#18 open renovate/dotenv-18.x | Update dependency dotenv to v18
#21 open renovate/express-5.x | Update dependency express to v5
#26 open renovate/pino-10.x | Update dependency pino to v10
#32 open renovate/uuid-14.x | Update dependency uuid to v14
## Pending Approval
- [ ] <!-- approve-branch=renovate/major-eslint-monorepo -->Update dependency eslint to
- [ ] <!-- approve-branch=renovate/major-jest-monorepo -->Update dependency jest to v30
- [ ] <!-- approve-all-pending-prs -->🔐 **Create all pending approval PRs at once** 🔐
## Rate-Limited
- [ ] <!-- unlimit-branch=renovate/all-minor-patch -->Update all non-major dependencies
## Open
27 PRs sind weg, mit „- autoclosed” im Titel. Geblieben sind die fünf
Majors, die schon einen PR hatten:
dependencyDashboardApproval gilt nur für neue Branches.
eslint und jest hatten wegen separateMultipleMajor andere
Branchnamen, sie warten jetzt auf Freigabe. Der Sammel-PR fehlt: Ohne
prHourlyLimit gilt wieder der Default 2, und in dieser
Stunde sind schon 32 PRs entstanden. Du holst ihn per Checkbox vor (Tag
14):
tick flut "$(dashnr flut)" unlimit-branch=renovate/all-minor-patch
renovate shop/flut | grep -E 'PR created|"result"'
api "$(R flut)/pulls?state=open" | jq -r '.[]
| select(.head.ref == "renovate/all-minor-patch") | .body' | grep -cE '^\| \['
prs flut closed | tail -2Erwartet:
INFO: PR created (repository=shop/flut, branch=renovate/all-minor-patch)
"result": "done",
6
#30 closed refs/pull/30/head | Update dependency uuid to v12 - autoclosed
#31 closed refs/pull/31/head | Update dependency uuid to v13 - autoclosed
Ein PR mit sechs Paketen statt 25 einzelnen. Die Checkbox umgeht
dabei auch prConcurrentLimit: Jetzt sind sechs PRs
offen.
Lehre:
- Aufräumen über die Config, nie per Massen-Schließen. Renovate schließt, was es nicht mehr braucht, und hinterlässt keine Ignores.
- Nach einer Flut bremst der Default
prHourlyLimitdie Reparatur („Rate-Limited” im Dashboard,Hourly PR Countim Debug-Log).
Fortschritt speichern? Kostenlos registrieren
Runde 6: Das ignorierte Major
Lagebild: In shop/major hat jemand im
Frühjahr den express-5-PR geschlossen. Jetzt will das Team doch
migrieren, aber Renovate liefert nichts.
prs major all
api "$(R major)/issues/3/comments" | jq -r '.[].body' | grep -E '^###|rename' \
| cut -c1-88Erwartet:
#1 open renovate/express-4.x | Update dependency express to v4.22.3
#2 open renovate/prettier-3.x | Update dependency prettier to v3.9.10
#3 closed refs/pull/3/head | Update dependency express to v5
### Renovate Ignore Notification
If you accidentally closed this PR, or if you changed your mind: rename this PR to get a
Auftrag: Ein offener PR für express 5, erzeugt von Renovate. Keine Config-Änderung.
Zeitbudget: 5 min · Punkte: 10
Hinweis: Das Dashboard hat für geschlossene PRs einen eigenen Abschnitt.
Lösung:
dash major | sed -n '/^## PR Closed/,/^## /p' | grep -E '^ - ' | cut -c1-88
tick major "$(dashnr major)" recreate-branch=renovate/express-5.x
renovate shop/major | grep -E 'PR created|"result"'
prs majorErwartet:
- [ ] <!-- recreate-branch=renovate/express-5.x -->[Update dependency express to v5](pu
INFO: PR created (repository=shop/major, branch=renovate/express-5.x)
"result": "done",
#1 open renovate/express-4.x | Update dependency express to v4.22.3
#2 open renovate/prettier-3.x | Update dependency prettier to v3.9.10
#5 open renovate/express-5.x | Update dependency express to v5
Ein neuer PR (#5), der alte bleibt geschlossen. Der Weg aus dem Kommentar geht auch: den Titel von #3 per API ändern, dann gilt die Sperre nicht mehr.
Lehre:
- Die Sperre hängt am Titel des geschlossenen PRs. Sie gilt für alle künftigen 5.x-Versionen, nicht nur für die damalige.
- Wer ein Major bewusst aufschiebt, schreibt das in die Config
(
allowedVersions, Tag 6) statt PRs zu schließen. Dann ist die Entscheidung sichtbar und reviewbar.
Fortschritt speichern? Kostenlos registrieren
Runde 7: Die private Registry
Lagebild: shop/bezahlung nutzt
@shop/money aus der Forgejo-Registry. Version 1.1.0 ist
seit Tagen veröffentlicht, ein PR kommt nicht.
grep -A2 'lookup failures' nacht.log | cut -c1-88
dash bezahlung | grep -A2 'Warning' | cut -c1-88Erwartet:
WARN: Package lookup failures (repository=shop/bezahlung)
"warnings": ["Failed to look up npm package @shop/money: no-result"],
"files": ["package.json"]
> ⚠️ **Warning**
>
> Renovate failed to look up the following dependencies: `Failed to look up npm package
Auftrag: PR für @shop/money 1.1.0,
Dashboard ohne Lookup-Warnung. Der Token gehört nicht ins Repo und
bleibt nicht in deiner Shell stehen.
Zeitbudget: 10 min · Punkte: 10
Hinweis: no-result sagt wenig; der
Statuscode der Registry-Anfrage im Debug-Log sagt alles.
Lösung:
api "$(R bezahlung)/raw/.npmrc"
LOG_LEVEL=debug renovate --dry-run=lookup shop/bezahlung > lookup.log 2>&1
grep -E 'statusCode=' lookup.log \
| sed -E 's/.*GET ([^ ]+) .*statusCode=(-?[0-9]+).*/\2 \1/' | sort -u
curl -s -H "Authorization: token $RENOVATE_TOKEN" \
"$FORGEJO/api/packages/shop/npm/@shop%2fmoney" | jq -c '{name, v: (.versions | keys)}'Erwartet:
@shop:registry=http://127.0.0.1:3000/api/packages/shop/npm/
401 http://127.0.0.1:3000/api/packages/shop/npm/@shop%2Fmoney
{"name":"@shop/money","v":["1.0.0","1.1.0"]}
Renovate fragt die Registry anonym, die Org ist limited.
Mit dem Bot-Token klappt es. Wie an Tag 8 bekommt Renovate eine
hostRules-Regel per Umgebung, hier in einer Datei, die du
nur für den Lauf in einer Subshell lädst:
cat > wk-creds.sh <<'EOF'
# wk-creds.sh – hostRules für die npm-Registry von Forgejo (nicht ins Repo!)
export RENOVATE_HOST_RULES=$(jq -nc --arg t "$RENOVATE_TOKEN" \
--arg h "$FORGEJO/api/packages/" '[{matchHost: $h, hostType: "npm", token: $t}]')
EOF
chmod 600 wk-creds.sh
(source wk-creds.sh && renovate shop/bezahlung) | grep -E 'WARN|PR created|"result"'
prs bezahlung
echo "RENOVATE_HOST_RULES in dieser Shell: ${RENOVATE_HOST_RULES:-leer}"Erwartet:
INFO: PR created (repository=shop/bezahlung, branch=renovate/shop-money-1.x)
"result": "done",
#2 open renovate/shop-money-1.x | Update dependency @shop/money to v1.1.0
RENOVATE_HOST_RULES in dieser Shell: leer
Lehre:
- Renovate schickt den Plattform-Token nicht automatisch an die
Paket-Registry, auch nicht auf demselben Host. Jede Registry braucht
eine eigene
hostRules-Regel. matchHostmithttp://-URL, weil das Lab ohne TLS läuft (Tag 8). In Produktionhttps://und ein Lese-Token, der nurread:packagekann. Lookup-Fehler stehen nur im Dashboard und im Log, nie als eigenes Issue.
Fortschritt speichern? Kostenlos registrieren
Runde 8 (Bonus): Das Lockfile streikt
Lagebild: shop/lager wollte „pro Paket
einen PR” und hat dafür eine Gruppe abgeschaltet. Seitdem sind drei von
vier PRs rot.
prs lager
for b in react-18.x react-dom-18.x react-19.x react-dom-19.x; do
printf '%-16s %s\n' $b "$(checks lager renovate/$b | sed -n 2p)"; done
api "$(R lager)/raw/renovate.json" | jq -c '{extends, ignorePresets}'Erwartet:
#1 open renovate/react-18.x | Update dependency react to v18.3.1
#2 open renovate/react-dom-18.x | Update dependency react-dom to v18.3.1
#3 open renovate/react-19.x | Update dependency react to v19
#4 open renovate/react-dom-19.x | Update dependency react-dom to v19
react-18.x
react-dom-18.x renovate/artifacts = failure (Artifact file update failure)
react-19.x renovate/artifacts = failure (Artifact file update failure)
react-dom-19.x renovate/artifacts = failure (Artifact file update failure)
{"extends":["config:recommended"],"ignorePresets":["group:monorepos"]}
Auftrag: Alle offenen PRs in lager ohne
Artefakt-Fehler. ignorePresets bleibt, das Team will die
großen Monorepo-Gruppen weiterhin nicht.
Zeitbudget: 10 min · Punkte: 10 (Bonus)
Hinweis: Lies den Kommentar „Artifact update problem” an einem der roten PRs.
Lösung:
api "$(R lager)/issues/3/comments" | jq -r '.[].body' \
| grep -E '^###|npm error (While|Found|peer|Conflicting)' | cut -c1-88Erwartet:
### ⚠️ Artifact update problem
##### File name: package-lock.json
npm error While resolving: [email protected]
npm error Found: [email protected]
npm error peer react@"^18.2.0" from [email protected]
npm error Conflicting peer dependency: [email protected]
react-dom verlangt per Peer-Dependency die passende
react-Version. Einzeln kann npm das Lockfile nicht auflösen
(ERESOLVE). Nur react 18.3.1 passt zufällig
noch zu react-dom 18.2.0. Die beiden gehören in eine
gezielte Gruppe:
klon lager
cat > renovate.json <<'EOF'
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": ["config:recommended"],
"ignorePresets": ["group:monorepos"],
"prHourlyLimit": 0,
"packageRules": [
{
"description": "react und react-dom nur gemeinsam (Peer-Dependency)",
"matchPackageNames": ["react", "react-dom"],
"groupName": "react"
}
]
}
EOF
ship "react und react-dom gruppieren"
cd .. && renovate shop/lager | grep -E 'PR created|Autoclosing|WARN|"result"'
prs lager
for b in react major-react; do printf '%-12s %s\n' $b \
"$(checks lager renovate/$b | head -1)"; doneErwartet:
✔ react und react-dom gruppieren
INFO: PR created (repository=shop/lager, branch=renovate/react)
INFO: PR created (repository=shop/lager, branch=renovate/major-react)
INFO: Autoclosing PR (repository=shop/lager)
INFO: Autoclosing PR (repository=shop/lager)
INFO: Autoclosing PR (repository=shop/lager)
INFO: Autoclosing PR (repository=shop/lager)
"result": "done",
#6 open renovate/react | Update react to v18.3.1
#7 open renovate/major-react | Update react to v19
react gesamt:
major-react gesamt:
Kein renovate/artifacts-Status mehr, die vier alten PRs
sind autoclosed.
Lehre:
group:monorepos(inconfig:recommended) ist kein Komfort, sondern verhindert genau diesen Fehler. Wer es abschaltet, muss Peer-Paare selbst gruppieren.- Ein Artefakt-Fehler macht den PR nicht kaputt, sondern
unvollständig:
package.jsonist geändert, das Lockfile nicht. Mergen wäre falsch, das sagt Renovate im Kommentar.
Fortschritt speichern? Kostenlos registrieren
Wertung
Volle Punkte nur im Zeitbudget und ohne Hinweis. Mit Hinweis oder bis zur doppelten Zeit gibt es die Hälfte, danach nichts.
| Runde | Zeitbudget | Punkte |
|---|---|---|
| 1 Ein Komma fehlt | 5 min | 10 |
| 2 Der rotierte Token | 10 min | 15 |
| 3 Der Regex sieht nichts | 10 min | 15 |
| 4 Automerge, der nie kommt | 15 min | 15 |
| 5 Die PR-Flut | 15 min | 15 |
| 6 Das ignorierte Major | 5 min | 10 |
| 7 Die private Registry | 10 min | 10 |
| 8 Das Lockfile streikt (Bonus) | 10 min | 10 |
| Summe | 80 min | 100 |
Ab 70 Punkten betreibst du Renovate für eine Organisation. Für jede verpasste Runde schreibst du eine Zeile ins Runbook: Symptom, erster Befehl, Lösung.
Kontrollpunkt
Nach allen Runden zählt der saubere Endzustand, nicht nur das verschwundene Symptom.
cd ~/renovate-lab/tag15
ok() { echo "✔ $1"; }; nok() { echo "✘ $1"; }
./wk-check.sh > /dev/null && ok "Wettkampf-Matrix grün" || nok "Wettkampf-Matrix rot"
curl -s -u renovate-bot:lab-bot-pw-123 "$FORGEJO/api/v1/users/renovate-bot/tokens" \
| jq -e 'all(.[]; .scopes != ["read:repository"])' > /dev/null \
&& ok "kein Rumpf-Token mehr" || nok "Token mit nur read:repository existiert"
[ -z "${RENOVATE_HOST_RULES:-}" ] && ok "keine hostRules in der Shell" \
|| nok "RENOVATE_HOST_RULES noch gesetzt"
api "$(R flut)/raw/renovate.json" | jq -e '.prConcurrentLimit > 0' > /dev/null \
&& ok "flut mit prConcurrentLimit" || nok "flut ohne Limit"Erwartet:
✔ Wettkampf-Matrix grün
✔ kein Rumpf-Token mehr
✔ keine hostRules in der Shell
✔ flut mit prConcurrentLimit
Challenge
Die Runden 1, 4, 5, 7 und 8 hätte ein Frühwarnsystem gemeldet, bevor
sich jemand beschwert. Schreib fruehwarnung.sh, das für
alle Repos der Org shop fünf Signale meldet: offenes
„Action Required”-Issue, Lookup-Fehler im Dashboard, mehr als zehn
offene PRs, Bot-PRs mit renovate/artifacts = failure und
Automerge-PRs mit Status pending. Teste es gegen eine
frische Aufstellung.
Hinweis: Die Org-Repos liefert
GET /orgs/shop/repos, den kombinierten Status eines
Branches GET /repos/{o}/{r}/commits/{branch}/status.
Lösung
Die Datei liegt auch unter
code/tag15/challenge/fruehwarnung.sh.
cat > fruehwarnung.sh <<'EOF'
#!/usr/bin/env bash
# fruehwarnung.sh – Warnsignale aus dem Wettkampf für alle Repos der Org shop.
# Nutzung: ./fruehwarnung.sh [max-offene-PRs] (Default 10, wie prConcurrentLimit)
LAB="${LAB:-$HOME/renovate-lab}"
source "$LAB/setup/env.sh"
MAX="${1:-10}"; found=0
api() { curl -sf -u "$ADMIN" "$@"; }
warn() { printf '%-10s %s\n' "$1" "$2"; found=$((found + 1)); }
for r in $(api "$FORGEJO/api/v1/orgs/shop/repos?limit=50" | jq -r '.[].name' | sort); do
A="$FORGEJO/api/v1/repos/shop/$r"
iss=$(api "$A/issues?type=issues&state=open&limit=50")
jq -e '.[] | select(.title | startswith("Action Required"))' <<<"$iss" >/dev/null \
&& warn "$r" "Config-Fehler-Issue offen"
jq -r '.[] | select(.title == "Dependency Dashboard") | .body' <<<"$iss" \
| grep -q 'Failed to look up' && warn "$r" "Lookup-Fehler im Dashboard"
prs=$(api "$A/pulls?state=open&limit=50")
n=$(jq length <<<"$prs"); [ "$n" -gt "$MAX" ] && warn "$r" "PR-Flut: $n offen"
for b in $(jq -r '.[] | select(.user.login == "renovate-bot") | .head.ref' <<<"$prs")
do
st=$(api "$A/commits/${b//\//%2F}/status")
jq -e '.statuses[]? | select(.context == "renovate/artifacts"
and .status == "failure")' <<<"$st" >/dev/null \
&& warn "$r" "Artefakt-Fehler: $b"
jq -e --arg b "$b" '.[] | select(.head.ref == $b)
| .body | contains("**Automerge**: Enabled")' <<<"$prs" >/dev/null \
&& [ "$(jq -r .state <<<"$st")" = pending ] \
&& warn "$r" "Automerge wartet auf pending: $b"
done
done
echo "Warnsignale: $found"
EOF
chmod +x fruehwarnung.sh
./fruehwarnung.sh
./aufstellung.sh > /dev/null && ./fruehwarnung.shErwartet:
Warnsignale: 0
automat Automerge wartet auf pending: renovate/prettier-3.x
bezahlung Lookup-Fehler im Dashboard
flut PR-Flut: 32 offen
kasse Config-Fehler-Issue offen
lager Artefakt-Fehler: renovate/react-dom-19.x
lager Artefakt-Fehler: renovate/react-19.x
lager Artefakt-Fehler: renovate/react-dom-18.x
Warnsignale: 7
Nach deinen Reparaturen ist alles still, nach der frischen Aufstellung meldet das Skript fünf der acht Runden. Die Runden 3 und 6 bleiben unsichtbar: Ein Regex, der nichts findet, und ein bewusst geschlossener PR sehen für jede Maschine normal aus. Runde 2 zeigt sich am Exit-Code des Renovate-Laufs, nicht in Forgejo.
Zum Schluss räumst du die Wettkampf-Repos und den Rotations-Token ab:
for r in kasse werkzeug automat flut major bezahlung lager; do
api -X DELETE "$(R $r)"; done
curl -s -o /dev/null -w "%{http_code}\n" -u renovate-bot:lab-bot-pw-123 -X DELETE \
"$FORGEJO/api/v1/users/renovate-bot/tokens/renovate-rotation"
rm -f wk-token wk-creds.shErwartet:
204
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Diese Drills gehören als Game Day ins Quartal, auf einer Staging-Instanz mit echten Repos. Gemessen wird die Zeit bis zur Erkennung, nicht nur bis zur Reparatur.
- Ein Frühwarnsystem wie
fruehwarnung.shläuft nach jedem Renovate-Lauf, dazu Alarme auf Exit-Code ≠ 0 und auf"result"ungleichdonein den JSON-Logs (Tag 9). - Token-Rotation als Runbook mit fester Scope-Liste, Probe-Lauf und Löschen des alten Tokens. Bei GitHub und GitLab gilt dasselbe für App-Rechte und Token-Scopes.
- Limits, Gruppen und
dependencyDashboardApprovalkommen aus dem Org-Preset (Tag 11). Ein Repo kann sie übersteuern, aber ein Review des Plattform-Teams sieht das. - Jede Runde endet mit einem neuen Test: Validator in der CI (Runde 1), Extract-Report mit Mindestanzahl Abhängigkeiten (Runde 3), Pflicht-Checks per Branch-Protection (Runde 4).