Tag 14: Dependency Dashboard und Fehlersuche
Ziel: Du steuerst Renovate komplett über Checkboxen per API, liest JSON-Logs mit jq und erkennst die typischen Fehlerbilder am ersten Blick. · Dauer: ca. 120 min · Voraussetzung: Tag 1, Tag 4
Briefing
- Das Dashboard ist ein Issue mit Checkboxen. Jede trägt einen Marker im HTML-Kommentar. Renovate liest sie beim nächsten Lauf und hakt sie danach wieder aus.
- Auch jeder PR hat eine Checkbox: „If you want to rebase/retry this PR”.
dependencyDashboardApprovalmacht aus dem Dashboard eine Freigabeschleuse.- Fehlersuche heißt:
LOG_LEVEL=debug LOG_FORMAT=json, dann jq. Vier Einträge beantworten fast jede Frage.
Mensch/Skript ──PATCH body: [ ] → [x]──► Issue/PR
│ nächster Lauf liest Marker
renovate ◄─────────────────────────────────┘ handelt, schreibt Body neu: [x] → [ ]
Drill 1: Gelände und erster Lauf
Frischer Stand mit einer Config direkt auf main, ohne
Onboarding-PR. Forgejo Actions schaltest du ab, sonst hängt jeder PR auf
„Waiting to run” (Tag 5). Das Label für das Dashboard legst du vorher
an, denn Forgejo verwirft unbekannte Labels still.
source ~/renovate-lab/setup/env.sh && ~/renovate-lab/setup/check.sh
~/renovate-lab/setup/seed.sh --reset
export RENOVATE_GITHUB_COM_TOKEN=$(gh auth token) # optional, Tag 1
mkdir -p ~/renovate-lab/tag14 && cd ~/renovate-lab/tag14
cp ~/renovate-lab/code/tag14/{fj.sh,rezepte.sh,sabotage.sh} . && source fj.sh
api -X PATCH "$API" -d '{"has_actions":false}' | jq -c '{has_actions}'
api -X POST "$API/labels" -d '{"name":"renovate","color":"#1f6feb"}' | jq -r .nameErwartet (gekürzt):
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
{"has_actions":false}
renovate
fj.sh kennst du in Teilen aus Tag 1. Neu sind
tick mit Rückmeldung, boxes (alle Checkboxen
eines Issues oder PRs), dashnr und put (Datei
per API auf main schreiben, ohne Klon).
cat > renovate.json <<'EOF'
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": ["config:recommended"],
"dependencyDashboardLabels": ["renovate"]
}
EOF
renovate-config-validator --no-global renovate.json | tail -1
put renovate.json renovate.json "Renovate einrichten"
renovate shop/shop-api 2>&1 | grep -E '(Branch|PR) created' | cut -c1-88
prs; issuesErwartet:
INFO: Config validated successfully against 1 file(s)
✔ renovate.json @ 8ab5446
INFO: Branch created (repository=shop/shop-api, branch=renovate/express-4.x)
INFO: PR created (repository=shop/shop-api, branch=renovate/express-4.x)
INFO: Branch created (repository=shop/shop-api, branch=renovate/prettier-3.x)
INFO: PR created (repository=shop/shop-api, branch=renovate/prettier-3.x)
#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 Dependency Dashboard [renovate]
Die Zielversionen stammen vom Testlauf, bei dir sind sie neuer. Zwei PRs, der Rest hängt am Stundenlimit (Tag 1).
Fortschritt speichern? Kostenlos registrieren
Drill 2: Anatomie des Dashboards
body 3 | grep -E '^(## |This issue)' | cut -c1-88
boxes 3Erwartet:
This issue lists Renovate updates and detected dependencies. Read the [Dependency Dashbo
## Rate-Limited
## Open
## Detected Dependencies
[ ] 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
[ ] rebase-branch=renovate/express-4.x
[ ] rebase-branch=renovate/prettier-3.x
[ ] rebase-all-open-prs
Ein Abschnitt erscheint nur, wenn er Einträge hat. Die wichtigsten
Abschnitte von Renovate 44.153.1 in der Reihenfolge, in der Renovate sie
schreibt (Quelle: dependency-dashboard.js im Paket):
| Abschnitt | Grund | Marker (<typ>-branch=…) |
Sammel-Checkbox |
|---|---|---|---|
| Repository Problems | WARN/ERROR im Lauf (Tag 8, 9) | – | – |
| Pending Approval | dependencyDashboardApproval |
approve |
approve-all-pending-prs |
| Awaiting Schedule | schedule (Tag 4) |
unschedule |
create-all-awaiting-schedule-prs |
| Rate-Limited | Limits (Tag 4) | unlimit |
create-all-rate-limited-prs |
| Errored | Fehler im Branch | retry |
– |
| PR Edited (Blocked) | fremder Commit im Branch | rebase |
– |
| Pending Status Checks | minimumReleaseAge (Tag 4) |
unpend |
– |
| Open | offene PRs | rebase |
rebase-all-open-prs |
| PR Closed (Blocked) | geschlossener PR (Tag 1) | recreate |
– |
| Detected Dependencies | alle gefundenen Abhängigkeiten | – | – |
Eine Checkbox „manual job” oder „Run Renovate again” gibt es im CLI 44 nicht, der Begriff kommt im Quelltext des Dashboards nicht vor. Die bietet nur die gehostete Mend-App an, weil die selbst entscheidet, wann sie läuft. Self-hosted ist der nächste Lauf dein CronJob (Tag 10) oder ein Aufruf von Hand.
Titel, Kopf- und Fußtext stellst du per Config ein.
dependencyDashboardLabels setzt Renovate übrigens nur, wenn
es den Issue-Text ohnehin neu schreibt. Entfernst du das Label von Hand,
bleibt es weg, bis sich am Dashboard etwas ändert (im Test bestätigt).
Jetzt der neue Titel:
jq '. + {dependencyDashboardTitle: "Renovate-Steuerpult",
dependencyDashboardFooter: "Zuständig: Platform-Team, Kanal #renovate"}' \
renovate.json > tmp.json && mv tmp.json renovate.json
put renovate.json renovate.json "Dashboard umbenennen"
renovate shop/shop-api >/dev/null 2>&1; issues
body 4 | grep -B1 ZuständigErwartet:
✔ renovate.json @ c06877d
#4 Renovate-Steuerpult [renovate]
#3 Dependency Dashboard [renovate]
---
Zuständig: Platform-Team, Kanal #renovate
Renovate sucht das Dashboard nur über den Titel. Das alte Issue #3 kennt es nicht mehr und lässt es verwaist offen. Schließ es selbst:
api -X PATCH "$API/issues/3" -d '{"state":"closed"}' | jq -r '"#\(.number) \(.state)"'
D=$(dashnr Renovate-Steuerpult); echo "Dashboard: #$D"Erwartet:
#3 closed
Dashboard: #4
Achtung: Wer
dependencyDashboardTitlein einem Org-Preset (Tag 11) ändert, hinterlässt in jedem Repo ein verwaistes Dashboard. Plane das Aufräumen mit ein.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Checkboxen per API
tick holt den Body, ersetzt
- [ ] <!-- marker --> durch
- [x] <!-- marker --> und schickt ihn per
PATCH zurück. Nichts anderes macht der Browser. Erst ein
einzelner Rebase:
echo "vorher: $(sha renovate/express-4.x) $(sha renovate/prettier-3.x)"
tick $D rebase-branch=renovate/express-4.x
LOG_LEVEL=debug renovate shop/shop-api > d3.log 2>&1
grep -E 'dependencyDashboardCheck=rebase|User has requested|Branch updated' d3.log \
| cut -c1-88
echo "nachher: $(sha renovate/express-4.x) $(sha renovate/prettier-3.x)"
boxes $D | grep express-4Erwartet (Hashes weichen ab):
vorher: 09a2959 faeee1a
✔ angehakt: rebase-branch=renovate/express-4.x
DEBUG: dependencyDashboardCheck=rebase (repository=shop/shop-api, branch=renovate/expres
DEBUG: User has requested rebase (repository=shop/shop-api, branch=renovate/express-4.x)
INFO: Branch updated (repository=shop/shop-api, branch=renovate/express-4.x)
nachher: 589c592 faeee1a
[ ] rebase-branch=renovate/express-4.x
Renovate baut den Branch neu auf main auf
(reuseExistingBranch: false), auch ohne Konflikt, und hakt
die Box danach wieder aus. Die Checkbox ist ein Auftrag, kein Zustand.
Jetzt alle offenen PRs auf einmal:
tick $D rebase-all-open-prs
renovate shop/shop-api 2>&1 | grep 'Branch updated' | cut -c1-88
echo "nachher: $(sha renovate/express-4.x) $(sha renovate/prettier-3.x)"Erwartet:
✔ angehakt: rebase-all-open-prs
INFO: Branch updated (repository=shop/shop-api, branch=renovate/express-4.x)
INFO: Branch updated (repository=shop/shop-api, branch=renovate/prettier-3.x)
nachher: a93c4bb a18cbe7
Tipp: Für Skripte und Notfälle gibt es dieselben Aufträge als globale, experimentelle CLI-Optionen:
--checked-branches=renovate/prettier-3.xwirkt wie ein Häkchen bei diesem Branch,--rebase-all-open-branches=truewierebase-all-open-prs. Im Test lieferte die erste Variante „Branch updated” für genau diesen Branch.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Freigabeschleuse mit dependencyDashboardApproval
Majors sollen erst nach einem Häkchen kommen, alles andere sofort.
Das Stundenlimit nimmst du raus, damit nur die Freigabe bremst. Die
Datei liegt auch als code/tag14/renovate-freigabe.json
bei.
cat > renovate.json <<'EOF'
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": ["config:recommended"],
"dependencyDashboardLabels": ["renovate"],
"dependencyDashboardTitle": "Renovate-Steuerpult",
"dependencyDashboardFooter": "Zuständig: Platform-Team, Kanal #renovate",
"prHourlyLimit": 0,
"packageRules": [
{
"description": "Majors nur nach Freigabe im Dashboard",
"matchUpdateTypes": ["major"],
"dependencyDashboardApproval": true
}
]
}
EOF
renovate-config-validator --no-global renovate.json | tail -1
put renovate.json renovate.json "Majors nur nach Freigabe"
renovate shop/shop-api 2>&1 | grep 'PR created' | cut -c1-88
body $D | sed -n '/^## Pending Approval/,/^## Open/p' | grep '^ - ' | cut -c1-88Erwartet:
INFO: Config validated successfully against 1 file(s)
✔ renovate.json @ 3d75ef3
INFO: PR created (repository=shop/shop-api, branch=renovate/node-20.x)
- [ ] <!-- approve-branch=renovate/actions-checkout-7.x -->Update actions/checkout acti
- [ ] <!-- approve-branch=renovate/actions-setup-node-7.x -->Update actions/setup-node
- [ ] <!-- approve-branch=renovate/express-5.x -->Update dependency express to v5
- [ ] <!-- approve-branch=renovate/node-24.x -->Update dependency node to v24
- [ ] <!-- approve-all-pending-prs -->🔐 **Create all pending approval PRs at once** 🔐
Der Minor-PR für Node kommt sofort, die vier Majors warten. Ohne Häkchen legt Renovate nicht einmal den Branch an. Du gibst express 5 frei:
tick $D approve-branch=renovate/express-5.x
LOG_LEVEL=debug renovate shop/shop-api > d4.log 2>&1
grep -E 'dependencyDashboardCheck=approve|creation is disabled|PR created' d4.log \
| sed -E 's/ \(repository=[^)]*\)$//' | cut -c1-88
prs | tail -2Erwartet:
✔ angehakt: approve-branch=renovate/express-5.x
DEBUG: Branch renovate/actions-checkout-7.x creation is disabled because dependencyDashb
DEBUG: Branch renovate/actions-setup-node-7.x creation is disabled because dependencyDas
DEBUG: dependencyDashboardCheck=approve
INFO: PR created
DEBUG: Branch renovate/node-24.x creation is disabled because dependencyDashboardApprova
#5 open renovate/node-20.x | Update Node.js to v20.20.2
#6 open renovate/express-5.x | Update dependency express to v5
Nach der Freigabe wandert express 5 in den Abschnitt „Open”. Die Freigabe gilt für den Branch, nicht dauerhaft: Kommt später express 6, wartet es wieder.
Tipp:
dependencyDashboardApproval: trueauf oberster Ebene schaltet die Schleuse für alle Updates ein. Das passt für Repos, die kaum gepflegt werden und nur auf Anforderung Updates bekommen sollen.
Fortschritt speichern? Kostenlos registrieren
Drill 5: PR-Checkbox, fremde Commits und recreateWhen
Ein Kollege „hilft” und committet in den Renovate-Branch von prettier:
git clone -q -b renovate/prettier-3.x \
"http://$ADMIN@127.0.0.1:3000/shop/shop-api.git" shop-api
echo "Hinweis vom Team" >> shop-api/README.md
git -C shop-api -c user.name="Lab Admin" -c [email protected] \
commit -qam "README im Renovate-Branch"
git -C shop-api push -q origin renovate/prettier-3.x 2>/dev/null; rm -rf shop-api
LOG_LEVEL=debug renovate shop/shop-api > d5.log 2>&1
grep 'prettier-3.x' d5.log | grep -E 'isModified\(\) =|has been edited' | cut -c1-88
body $D | grep -E '^## '
api "$API/issues/2/comments" | jq -r '.[-1].body' | head -4 | fold -s -w 88Erwartet:
DEBUG: Checking if PR has been edited (repository=shop/shop-api, branch=renovate/prettie
DEBUG: branch.isModified() = true (repository=shop/shop-api, baseBranch=main, branch=ren
DEBUG: PR has been edited, PrNo:2 (repository=shop/shop-api, branch=renovate/prettier-3.
## Pending Approval
## PR Edited (Blocked)
## Open
## Detected Dependencies
### Edited/Blocked Notification
Renovate will not automatically rebase this PR, because it does not recognize the last
commit author and assumes somebody else may have edited the PR.
Ab jetzt fasst Renovate PR #2 nicht mehr an, auch wenn prettier ein neues Release bekommt. Zurück holst du ihn mit der Checkbox im PR selbst:
boxes 2
echo "vorher: $(sha renovate/prettier-3.x)"; tick 2 rebase-check
LOG_LEVEL=debug renovate shop/shop-api > d5b.log 2>&1
grep -E 'Manual rebase requested|prettier-3.x\)$' d5b.log | grep -E 'Manual|INFO' \
| cut -c1-88
echo "nachher: $(sha renovate/prettier-3.x)"
api "$API/raw/README.md?ref=renovate/prettier-3.x" | grep -c 'Hinweis vom Team'Erwartet:
[ ] rebase-check
vorher: f95b597
✔ angehakt: rebase-check
DEBUG: Manual rebase requested via PR checkbox for #2 (repository=shop/shop-api, branch=
DEBUG: Manual rebase has been requested for PR (repository=shop/shop-api, branch=renovat
INFO: Branch updated (repository=shop/shop-api, branch=renovate/prettier-3.x)
INFO: PR updated (repository=shop/shop-api, branch=renovate/prettier-3.x)
nachher: c13c7df
0
Die README-Änderung ist weg, wie der Kommentar warnte („custom
changes will be lost”). Statt der Checkbox geht auch das Label
rebase (Option rebaseLabel): Renovate rebased
und entfernt das Label wieder (Debug: „Manual rebase requested via PR
labels”). Das passt für Bots, die nur Labels setzen dürfen. Auf
Bitbucket und Azure DevOps schreibt Renovate statt der Checkbox „rename
this PR to start with rebase!” in den PR-Text.
Jetzt recreateWhen. Du schließt den express-Patch-PR
#1:
api -X PATCH "$API/pulls/1" -d '{"state":"closed"}' | jq -r '"#\(.number) \(.state)"'
LOG_LEVEL=debug renovate shop/shop-api 2>&1 | grep -E 'Closed PR #|PR created' \
| cut -c1-88Erwartet:
#1 closed
DEBUG: Closed PR #1 already exists. Skipping branch. (repository=shop/shop-api, branch=r
Mit recreateWhen: "auto" (Default) bleibt ein
geschlossener Einzel-PR ignoriert. Nur Gruppen, Digest-Updates und
Lockfile-Maintenance kommen von selbst wieder. Patches von express
sollen aber nie still liegen bleiben:
jq '.packageRules += [{description: "express-Patches nie dauerhaft ignorieren",
matchPackageNames: ["express"], matchUpdateTypes: ["minor", "patch"],
recreateWhen: "always"}]' renovate.json > tmp.json && mv tmp.json renovate.json
renovate-config-validator --no-global renovate.json | tail -1
put renovate.json renovate.json "express immer neu anlegen"
LOG_LEVEL=debug renovate shop/shop-api 2>&1 \
| grep -E 'recreateClosed is true|PR created' | cut -c1-88
prs all | grep expressErwartet:
INFO: Config validated successfully against 1 file(s)
✔ renovate.json @ 53c5e0e
DEBUG: recreateClosed is true. No need to check for closed PR. (repository=shop/shop-api
INFO: PR created (repository=shop/shop-api, branch=renovate/express-4.x)
#1 closed renovate/express-4.x | Update dependency express to v4.22.3
#6 open renovate/express-5.x | Update dependency express to v5
#7 open renovate/express-4.x | Update dependency express to v4.22.3
recreateWhen |
geschlossener PR wird … |
|---|---|
auto |
nur bei Gruppen, Digests, Lockfile-Maintenance neu angelegt |
always |
bei jedem Lauf neu angelegt – Schließen ist zwecklos |
never |
nie neu angelegt, auch nicht bei Gruppen |
Fortschritt speichern? Kostenlos registrieren
Drill 6: JSON-Logs mit jq auswerten
Die Textausgabe von LOG_LEVEL=debug ist für grep gut,
für Fragen wie „Welche Updates hat Renovate gefunden?” nicht.
rezepte.sh aus dem Begleitcode bündelt fünf jq-Abfragen:
levels, probleme, updates,
branches und warum.
LOG_LEVEL=debug LOG_FORMAT=json renovate shop/shop-api > lauf.json 2>&1
source rezepte.sh
levels lauf.json; probleme lauf.json; updates lauf.jsonErwartet:
634 20
6 30
Dockerfile: node 20.11.0-alpine -> 20.20.2 (minor), 24.21.0 (major)
.github/workflows/ci.yml: actions/checkout v3 -> v7.0.1 (major)
.github/workflows/ci.yml: actions/setup-node v3 -> v7.1.0 (major)
.github/workflows/ci.yml: ubuntu latest -> [skip: invalid-version]
.github/workflows/ci.yml: node 20 -> 24.21.0 (major)
package.json: express 4.18.2 -> 4.22.3 (minor), 5.3.0 (major)
package.json: lodash ^4.17.20 ->
package.json: prettier 3.0.0 -> 3.9.10 (minor)
probleme ist leer, der Lauf war sauber.
updates liest den Eintrag
packageFiles with updates: das komplette Ergebnis von
Extraktion und Lookup, mit skipReason und Lookup-Warnungen
pro Abhängigkeit. Ohne GitHub-Token stünde bei den Actions
[skip: github-token-required]. Was Renovate pro Branch
entschieden hat:
branches lauf.json
warum lauf.json node-24.x | tail -3Erwartet:
done #7 renovate/express-4.x
done #2 renovate/prettier-3.x
done #5 renovate/node-20.x
needs-approval #- renovate/actions-checkout-7.x
needs-approval #- renovate/actions-setup-node-7.x
done #6 renovate/express-5.x
needs-approval #- renovate/node-24.x
findPr(renovate/node-24.x, Update dependency node to v24, !open)
prAlreadyExisted=false
Branch renovate/node-24.x creation is disabled because dependencyDashboardApproval=true
branches liest branches info extended. Das
Feld result ist dieselbe Ursache, aus der das Dashboard
seine Abschnitte baut: needs-approval,
not-scheduled, pr-limit-reached,
already-existed, pr-edited,
error. warum erzählt die Entscheidungskette
eines Branches in Renovates eigenen Worten.
Zum Schluss --dry-run=full gegen den echten Lauf. Du
gibst node 24 frei und fragst erst den Probelauf:
tick $D approve-branch=renovate/node-24.x
renovate --dry-run=full shop/shop-api 2>&1 | grep DRY-RUN | cut -c1-88
boxes $D | grep node-24; prs | grep -c node-24
renovate shop/shop-api 2>&1 | grep -E '(Branch|PR) created' | cut -c1-88
boxes $D | grep node-24Erwartet:
✔ angehakt: approve-branch=renovate/node-24.x
INFO: DRY-RUN: Would commit files to branch renovate/node-24.x. See debug logs for raw
INFO: DRY-RUN: Would ensure Dependency Dashboard (repository=shop/shop-api)
INFO: DRY-RUN: Would save repository cache. (repository=shop/shop-api)
[x] approve-branch=renovate/node-24.x
0
INFO: Branch created (repository=shop/shop-api, branch=renovate/node-24.x)
INFO: PR created (repository=shop/shop-api, branch=renovate/node-24.x)
[ ] rebase-branch=renovate/node-24.x
Der Probelauf liest die Checkbox, lässt sie aber stehen. Einen „Would
create PR” siehst du nicht: Ohne echten Branch endet die Simulation beim
Commit. Für Fragen zu PR-Titel oder -Text ist
--dry-run=full deshalb nur eine halbe Antwort.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Fehlerbild kaputte Config
Ein Tippfehler, wie er beim Bearbeiten im Browser passiert:
cp renovate.json renovate.gut.json
sed 's/"prHourlyLimit": 0,/&,/' renovate.gut.json > kaputt.json
put renovate.json kaputt.json "Limit anpassen"
LOG_LEVEL=debug LOG_FORMAT=json renovate shop/shop-api > kaputt.log 2>&1
echo "exit=$?"; probleme kaputt.log
jq -c 'select(.msg == "Repository finished") | {result, status}' kaputt.log
issues; body 9 | fold -s -w 88Erwartet:
✔ renovate.json @ 19dfff8
exit=0
40 - Repository has invalid config | Invalid JSON (parsing failed)
40 - Configuration Warning
{"result":"config-validation","status":"onboarded"}
#9 Action Required: Fix Renovate Configuration []
#4 Renovate-Steuerpult [renovate]
There is an error with this repository's Renovate configuration that needs to be fixed.
As a precaution, Renovate will stop PRs until it is resolved.
Location: `renovate.json`
Error type: Invalid JSON (parsing failed)
Message: Syntax error: expecting String near ": 0,,
"
„Stop PRs” heißt: Renovate fasst gar nichts mehr an, auch keine Aufträge aus Checkboxen. Probe mit dem Rebase-Häkchen in PR #2, dann reparieren:
echo "vorher: $(sha renovate/prettier-3.x)"; tick 2 rebase-check
renovate shop/shop-api 2>&1 | grep -E 'WARN|Branch updated' | cut -c1-88
echo "nachher: $(sha renovate/prettier-3.x)"
put renovate.json renovate.gut.json "Config repariert"
renovate shop/shop-api 2>&1 | grep -E 'WARN|Branch updated' | cut -c1-88
echo "repariert: $(sha renovate/prettier-3.x), Issue #9: $(api "$API/issues/9" \
| jq -r .state)"Erwartet:
vorher: c13c7df
✔ angehakt: rebase-check
WARN: Repository has invalid config (repository=shop/shop-api)
nachher: c13c7df
✔ renovate.json @ 88b8380
INFO: Branch updated (repository=shop/shop-api, branch=renovate/prettier-3.x)
repariert: 7d7e68d, Issue #9: closed
Das Häkchen hat den Ausfall überlebt und wurde nachgeholt, das Issue
schließt Renovate selbst. Der Exit-Code war 0 (Tag 9:
exitCodeForErrors). Und
renovate-config-validator --no-global kaputt.json hätte das
vor dem Push gefunden („JSON5: invalid character ‘,’ at 11:22”, Exit 1,
Tag 2).
Fortschritt speichern? Kostenlos registrieren
Drill 8: Lookup-, Artefakt- und Rechtefehler
Jemand trägt express-validator ein und vertippt sich.
Achtung bei der Wahl des Tippfehlers: Viele naheliegende Namen sind auf
npmjs.com belegt.
for p in lodahs expresss expres-validator; do
printf '%s: ' $p; npm view $p version 2>&1 | head -1; doneErwartet:
lodahs: 0.0.1-security
expresss: 0.0.0
expres-validator: npm error code E404
Sicherheit:
lodahsist ein Sicherheits-Platzhalter von npm,expresssein fremdes Paket. Ein solcher Tippfehler erzeugt keinen Lookup-Fehler, sondern installiert Fremdcode, und Renovate hält ihn brav aktuell. Lies neue Einträge in „Detected Dependencies” kritisch.
api "$API/raw/package.json" | jq '.dependencies["expres-validator"] = "7.2.1"' \
> package.json
put package.json package.json "Validierung ergänzen"
LOG_LEVEL=debug LOG_FORMAT=json renovate shop/shop-api > lookup.log 2>&1
probleme lookup.log | sort | uniq -c
updates lookup.log | grep expres- | cut -c1-88Erwartet:
✔ package.json @ 9e32f81
1 40 - Package lookup failures
1 40 renovate/express-4.x artifactErrors
1 40 renovate/express-4.x Package lookup failures
1 40 renovate/express-5.x artifactErrors
1 40 renovate/express-5.x Package lookup failures
1 40 renovate/node-20.x Package lookup failures
1 40 renovate/node-24.x Package lookup failures
1 40 renovate/prettier-3.x Package lookup failures
package.json: expres-validator 7.2.1 -> [warn: Failed to look up npm package expres-va
Ein Fehler, zwei Fehlerbilder. Erstens der Lookup-Fehler: Renovate findet keine Versionen, schreibt ins Dashboard und in jeden PR-Text einen Block „⚠️ Warning – Renovate failed to look up the following dependencies”, arbeitet aber weiter.
Zweitens der Artefakt-Fehler: Die express-PRs ändern
dieselbe Stelle in package.json wie dein Commit, also hat
Renovate sie neu aufgebaut. Dabei ruft es
npm install --package-lock-only auf, und npm scheitert am
unbekannten Paket.
jq -r 'select(.artifactErrors) | [.branch, (.artifactErrors[0].stderr
| split("\n") | map(select(startswith("npm error code"))) | first)]
| join(": ")' lookup.log
api "$API/commits/renovate%2Fexpress-4.x/status" \
| jq -r '.statuses[] | "\(.context) = \(.status) – \(.description)"'
api "$API/issues/7/comments" | jq -r '.[-1].body' | grep -E '^#|E404' | cut -c1-88Erwartet:
renovate/express-4.x: npm error code E404
renovate/express-5.x: npm error code E404
renovate/artifacts = failure – Artifact file update failure
### ⚠️ Artifact update problem
##### File name: package-lock.json
npm error code E404
prettier und node blieben unberührt, weil ihre Branches keinen
Konflikt hatten. Ein Artefakt-Fehler zeigt sich also nur dort, wo
Renovate gerade das Lockfile anfasst. Die Reparatur passiert auf
main:
api "$API/raw/package.json" | jq 'del(.dependencies["expres-validator"])' \
> package.json
put package.json package.json "Tippfehler entfernt"
renovate shop/shop-api 2>&1 | grep -E 'WARN|Branch updated' | cut -c1-88
api "$API/commits/renovate%2Fexpress-4.x/status" | jq -c '[.statuses[]?.status]'Erwartet:
✔ package.json @ eeb5e89
INFO: Branch updated (repository=shop/shop-api, branch=renovate/express-4.x)
INFO: Branch updated (repository=shop/shop-api, branch=renovate/express-5.x)
[]
Der neue Commit trägt keinen failure mehr. Renovate
setzt renovate/artifacts nur im Fehlerfall. Hätte es keinen
Konflikt gegeben, wäre rebase-check im PR der Weg gewesen,
siehe Kommentar („you click the rebase/retry checkbox”).
Letztes Fehlerbild: Der Bot verliert sein Schreibrecht.
api -X DELETE "$API/collaborators/renovate-bot" && echo "Bot entfernt"
curl -s -H "Authorization: token $RENOVATE_TOKEN" "$API" | jq -c .permissions
LOG_LEVEL=debug renovate shop/shop-api > rechte.log 2>&1; echo "exit=$?"
grep -E 'does not permit|"result"' rechte.log | cut -c1-88
api -X PUT "$API/collaborators/renovate-bot" -d '{"permission":"write"}' \
&& echo "Bot wieder Collaborator"Erwartet:
Bot entfernt
{"admin":false,"push":false,"pull":true}
exit=0
DEBUG: Repository does not permit pull or push - aborting renovation (repository=shop/sh
"result": "forbidden",
Bot wieder Collaborator
Kein Issue (der Bot dürfte es gar nicht schreiben), kein WARN, Exit
0, nach 11 ms fertig. Mit Level info siehst du nur
„Repository is forbidden”. Das ist das heimtückischste Fehlerbild:
Renovate verstummt einfach. Bei autodiscover taucht das
Repo nicht einmal mehr in der Liste auf (Tag 9).
Fortschritt speichern? Kostenlos registrieren
Diagnose-Checkliste
| Symptom | erster Blick | Ursache | Fix |
|---|---|---|---|
| Issue „Action Required: Fix Renovate Configuration”, nichts passiert mehr | Issue-Text, probleme |
renovate.json ungültig (JSON, Option, Preset) |
Validator, reparieren; Issue schließt sich |
| Dashboard-Warnung „failed to look up” | updates … [warn: …] |
Tippfehler, privates Paket ohne hostRules (Tag 8) |
Name korrigieren, Zugangsdaten |
renovate/artifacts: failure + Kommentar „Artifact
update problem” |
Kommentar, artifactErrors im Log |
Lockfile-Tool scheitert: E404, Engine, fehlende Toolchain | auf main beheben, dann rebase-check |
Repo wird still übersprungen, result: forbidden |
„Repository finished” | Bot ohne Schreibrecht | Collaborator write, Token-Scopes (Tag 12) |
| Update kommt nie, „PR Closed (Blocked)” | branches: already-existed |
geschlossener PR mit gleichem Titel | recreate-branch, recreateWhen,
Config-Regel |
| PR wird nicht mehr aktualisiert, „PR Edited (Blocked)” | Kommentar „Edited/Blocked Notification” | fremder Commit im Branch | rebase-check oder Label rebase |
| Update steht in „Pending Approval” | branches: needs-approval |
dependencyDashboardApproval |
approve-branch |
| Update fehlt komplett, auch im Dashboard | updates … [skip: …] |
skipReason, z. B.
github-token-required |
Token, enabled/ignoreDeps prüfen |
| Dashboard verdoppelt | issues |
dependencyDashboardTitle geändert |
altes Issue schließen |
| CronJob grün trotz Fehler | Exit-Code | Default: Repo-Fehler ergeben Exit 0 | exitCodeForErrors: true (Tag 9) |
Kontrollpunkt
Das Prüfskript liegt im Begleitcode. Es prüft Dashboard, Config,
package.json, Bot-Rechte und die Status-Checks aller
offenen PRs.
bash ~/renovate-lab/code/tag14/kontrolle.shErwartet:
✔ Dashboard heißt Renovate-Steuerpult und trägt Label renovate
✔ kein verwaistes Dependency Dashboard offen
✔ kein Issue „Action Required“ offen
✔ Majors brauchen Freigabe (packageRule)
✔ Tippfehler aus package.json entfernt
✔ Bot hat Schreibrecht
✔ kein Renovate-Branch mit Status failure
Challenge
sabotage.sh spielt einen unruhigen Vormittag nach: Ein
Kollege schließt einen PR, ein anderer committet in einen
Renovate-Branch. Finde nur mit dem JSON-Log heraus, welche Branches
blockiert sind und warum. Bring dann mit Checkboxen und genau
einem Renovate-Lauf alle Updates als offene PRs zurück, ohne
renovate.json anzufassen.
Hinweis: branches zeigt dir die
Ursache, die Tabelle in Drill 2 den Marker dazu.
Lösung
cd ~/renovate-lab/tag14 && source fj.sh && source rezepte.sh
bash sabotage.sh
LOG_LEVEL=debug LOG_FORMAT=json renovate shop/shop-api > ch.log 2>&1
branches ch.log | grep -v '^done'
warum ch.log node-20.x | grep 'edited,'; warum ch.log express-5.x | grep 'Closed PR'Erwartet:
✔ Sabotage erledigt
pr-edited #5 renovate/node-20.x
needs-approval #- renovate/actions-checkout-7.x
needs-approval #- renovate/actions-setup-node-7.x
already-existed #6 renovate/express-5.x
PR has been edited, PrNo:5
Closed PR #6 already exists. Skipping branch.
Drei Ursachen, drei Marker. Die beiden Actions-Majors warten noch aus Drill 4 auf Freigabe, dafür reicht die Sammel-Checkbox.
D=$(dashnr Renovate-Steuerpult)
tick $D rebase-branch=renovate/node-20.x
tick $D recreate-branch=renovate/express-5.x
tick $D approve-all-pending-prs
LOG_LEVEL=debug LOG_FORMAT=json renovate shop/shop-api > ch2.log 2>&1
branches ch2.log | grep -v '^done'
api "$API/raw/Dockerfile?ref=renovate/node-20.x" | grep -c HotfixErwartet:
✔ angehakt: rebase-branch=renovate/node-20.x
✔ angehakt: recreate-branch=renovate/express-5.x
✔ angehakt: approve-all-pending-prs
pr-created #10 renovate/actions-checkout-7.x
pr-created #11 renovate/actions-setup-node-7.x
pr-created #12 renovate/express-5.x
0
node 20 ist wieder done, der Hotfix-Commit verworfen.
express 5 bekommt einen neuen PR #12, der geschlossene #6 bleibt zu. Im
Browser hättest du dafür drei Klicks gebraucht, per API sind es drei
Zeilen, die du in ein Runbook schreiben kannst.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Erkläre das Dashboard zur offiziellen Schnittstelle: Freigaben,
Rebase-Wünsche und Ablehnungen laufen über Checkboxen, nicht über
Commits in
renovate/*-Branches. dependencyDashboardApprovalfür Majors ist ein sauberer Change-Gate-Nachweis. Wer den Haken setzt, steht in der Issue-Historie der Plattform.- Sammle Renovate-Logs zentral als JSON (
LOG_FORMAT=json,LOG_FILEmitLOG_FILE_LEVEL=debug, Tag 9) und alarmiere aufresult≠done, besonders aufforbiddenundconfig-validation. - Prüfe Bot-Rechte regelmäßig per API (
permissions.pushpro Repo). Ein entzogenes Recht erzeugt weder Issue noch Fehler-Exit. - Änderungen an
dependencyDashboardTitleoder-Labelsim Org-Preset brauchen einen Aufräumplan für die alten Issues in allen Repos.