Zum Inhalt springen
Trainingslager IT-Trainingslager

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”.
  • dependencyDashboardApproval macht 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 .name

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

Erwartet:

 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 3

Erwartet:

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ändig

Erwartet:

✔ 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 dependencyDashboardTitle in 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-4

Erwartet (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.x wirkt wie ein Häkchen bei diesem Branch, --rebase-all-open-branches=true wie rebase-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-88

Erwartet:

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

Erwartet:

✔ 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: true auf 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 88

Erwartet:

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

Erwartet:

#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 express

Erwartet:

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

Erwartet:

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

Erwartet:

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

Erwartet:

✔ 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 88

Erwartet:

✔ 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; done

Erwartet:

lodahs: 0.0.1-security
expresss: 0.0.0
expres-validator: npm error code E404

Sicherheit: lodahs ist ein Sicherheits-Platzhalter von npm, expresss ein 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-88

Erwartet:

✔ 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-88

Erwartet:

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

Erwartet:

✔ 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 Hotfix

Erwartet:

✔ 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.
  • dependencyDashboardApproval fü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_FILE mit LOG_FILE_LEVEL=debug, Tag 9) und alarmiere auf result ≠ done, besonders auf forbidden und config-validation.
  • Prüfe Bot-Rechte regelmäßig per API (permissions.push pro Repo). Ein entzogenes Recht erzeugt weder Issue noch Fehler-Exit.
  • Änderungen an dependencyDashboardTitle oder -Labels im Org-Preset brauchen einen Aufräumplan für die alten Issues in allen Repos.