Zum Inhalt springen
Trainingslager IT-Trainingslager

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.sh baut alle Startzustände auf einmal, inklusive „Nachtlauf” von Renovate.
  • Pro Runde: Lagebild aufnehmen, Stoppuhr starten, reparieren, bis wk-check.sh die 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.sh

Erwartet (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/kasse fü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-88

Erwartet:

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

Erwartet:

 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 all

Erwartet:

✔ 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.json tolerant 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.log

Erwartet:

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 failure heiß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:package nur, 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/Makefile

Erwartet:

<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=extract zeigen die Lücke.
  • Zwei Debug-Zeilen trennen die Fehlerquellen: Matched N file(s) (Dateimuster) und No 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.x

Erwartet:

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

Erwartet:

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 prettier

Erwartet:

{"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 pending ist, 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.
  • platformAutomerge auf 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-88

Erwartet:

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

Erwartet:

 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 prHourlyLimit die Reparatur („Rate-Limited” im Dashboard, Hourly PR Count im 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-88

Erwartet:

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

Erwartet:

 - [ ] <!-- 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-88

Erwartet:

 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.
  • matchHost mit http://-URL, weil das Lab ohne TLS läuft (Tag 8). In Produktion https:// und ein Lese-Token, der nur read:package kann. 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-88

Erwartet:

### ⚠️ 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)"; done

Erwartet:

✔ 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 (in config: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.json ist 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.sh

Erwartet:

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

Erwartet:

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.sh läuft nach jedem Renovate-Lauf, dazu Alarme auf Exit-Code ≠ 0 und auf "result" ungleich done in 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 dependencyDashboardApproval kommen 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).