Tag 0: Das Trainingsgelände
Ziel: Node 24, Renovate-CLI und ein lokales Forgejo mit Bot-User und Demo-Repo aufbauen und Renovate zum ersten Mal gefahrlos auf
shop/shop-apiloslassen. · Dauer: ca. 45 min · Voraussetzung: keine
Briefing
- Renovate läuft als CLI auf deinem Laptop (Node 24, lokal installiert), nicht als App in der Cloud.
- Die Plattform ist Forgejo in Docker auf
http://127.0.0.1:3000. Dort legt Renovate echte Branches, PRs und Issues an – ohne GitHub-Konto. - Renovate arbeitet als eigener User
renovate-botmit einem Token. Du selbst bistlab-adminund spielst den Menschen, der PRs mergt. up.sh,seed.shundcheck.shbauen das Gelände auf, füllen es und prüfen es.
Laptop Docker
┌───────────────────────────────┐ ┌──────────────────────────────┐
│ ~/renovate-lab/ │ REST API │ Container "forgejo" │
│ tools/ renovate 44.153.1 │ ─────────► │ http://127.0.0.1:3000 │
│ setup/ up.sh env.sh ... │ git push │ Org shop │
│ code/ Begleitcode │ ◄────────► │ Repo shop/shop-api │
│ Node 24, git, jq, curl │ │ lab-admin, renovate-bot │
└───────────────────────────────┘ └──────────────────────────────┘
│ Lookups (npm, Docker Hub, GitHub)
▼
Internet
Drill 1: Werkzeuge prüfen
docker version --format '{{.Server.Version}}'
node -v
npm -v
git --version
jq --version
curl --version | head -1 | cut -d' ' -f1-2
gh --version | head -1 # optionalErwartet (kann je nach Version abweichen):
29.5.2
v24.21.0
11.19.0
git version 2.56.0
jq-1.8.2
curl 8.7.1
gh version 2.102.0 (2026-09-30)
gh brauchst du nur für den optionalen GitHub-Token in
Drill 7. Zeigt node -v etwas anderes als
v24.x, mach mit Drill 2 weiter, sonst überspring ihn.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Node 24 bereitstellen
Renovate 44 verlangt Node ^24.11.0 (Feld
engines in seiner package.json). Node 25 oder
26 ist zu neu, Node 22 zu alt. Mit mise legst du die Version nur für das
Lab-Verzeichnis fest:
mkdir -p ~/renovate-lab && cd ~/renovate-lab
mise use node@24 # schreibt mise.toml, gilt in ~/renovate-lab und darunter
node -vErwartet (kann je nach Version abweichen):
v24.21.0
Ohne mise: brew install node@24 und
export PATH="$(brew --prefix node@24)/bin:$PATH" (keg-only,
landet sonst nicht im PATH). check.sh meldet
später ✘, sobald im Terminal das falsche Node aktiv ist.
Und mit dem falschen Node? So sieht der Lauf aus Drill 6 unter Node v25.3.0 aus:
WARN: RE2 not usable, falling back to RegExp
...
ERROR: Unsupported node environment detected. Please update your node version.
"versions": {
"node": "25.3.0",
...
INFO: Renovate is exiting with a non-zero code due to the following logged errors
Renovate läuft durch, endet aber mit Exit-Code 1 – in einer Pipeline ist jeder Lauf rot. Das native Regex-Modul RE2 ist für Node 24 gebaut und fällt ebenfalls weg.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Arbeitsverzeichnis, Begleitcode und Renovate-CLI
Den Begleitcode holst du einmal von GitHub nach
~/renovate-lab/code, die Setup-Skripte daraus kopierst du
nach ~/renovate-lab/setup:
mkdir -p ~/renovate-lab/tag00 && cd ~/renovate-lab
git clone https://github.com/thomaszachmann/renovate-zum-anfassen.git \
~/renovate-lab/code
cp -R ~/renovate-lab/code/setup ~/renovate-lab/setup
ls ~/renovate-lab/setup
ls ~/renovate-lab/setup/shop-apiErwartet:
Cloning into '…/renovate-lab/code'...
check.sh env.sh mkrepo.sh seed.sh shop-api up.sh
Dockerfile index.js package-lock.json package.json README.md
Renovate installierst du lokal in ~/renovate-lab/tools,
nicht global – die Version bleibt fest auf 44.153.1:
npm install --prefix ~/renovate-lab/tools [email protected]Erwartet (gekürzt, kann je nach Version abweichen):
npm warn deprecated [email protected]: This module is not supported, and leaks memory. …
...
added 618 packages in 25s
...
npm warn install-scripts 4 packages have install scripts not yet covered by …
Die Warnungen sind harmlos, RE2 kommt als vorgebautes Binary mit. Die
Installation belegt etwa 350 MB. env.sh setzt alles, was
Renovate und die Skripte brauchen:
grep -v '^#' ~/renovate-lab/setup/env.shErwartet:
LAB="${LAB:-$HOME/renovate-lab}"
export PATH="$LAB/tools/node_modules/.bin:$PATH"
export FORGEJO_PORT="${FORGEJO_PORT:-3000}"
export FORGEJO="http://127.0.0.1:$FORGEJO_PORT"
export ADMIN="lab-admin:lab-admin-pw-123" # Lab-Wert!
export RENOVATE_PLATFORM=forgejo
export RENOVATE_ENDPOINT="$FORGEJO/api/v1"
export RENOVATE_TOKEN="$(cat "$LAB/setup/bot-token" 2>/dev/null)"
export RENOVATE_GIT_AUTHOR="Renovate Bot <[email protected]>"
export LOG_LEVEL="${LOG_LEVEL:-info}"
Jede Renovate-Option lässt sich als
RENOVATE_<OPTION> setzen (platform →
RENOVATE_PLATFORM). LOG_LEVEL und
LOG_FORMAT liest Renovate ohne Präfix. Laden:
source ~/renovate-lab/setup/env.sh
renovate --version
renovate-config-validator --help | head -1Erwartet:
44.153.1
Usage: renovate-config-validator [options] [config-files...]
RENOVATE_TOKEN ist noch leer, die Datei
bot-token entsteht erst im nächsten Drill.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Forgejo starten
up.sh ist idempotent und macht drei Dinge:
- startet den Container
forgejo(Imagecodeberg.org/forgejo/forgejo:16.0.6-rootless, SQLite, Volumesforgejo-dataundforgejo-conf), falls er fehlt, - legt die User
lab-admin(Admin) undrenovate-bot(normaler User) an, - erzeugt einen Token für
renovate-botund schreibt ihn nach~/renovate-lab/setup/bot-token(Rechte600).
cd ~/renovate-lab/setup
./up.sh
docker ps --filter name=forgejo --format '{{.Names}} {{.Status}} {{.Ports}}'Erwartet (beim ersten Mal zieht Docker vorher das Image):
New user 'lab-admin' has been successfully created!
New user 'renovate-bot' has been successfully created!
✔ Forgejo läuft: http://127.0.0.1:3000 (lab-admin / lab-admin-pw-123)
forgejo Up 8 seconds 2222/tcp, 127.0.0.1:3000->3000/tcp
Ein zweiter Aufruf von ./up.sh gibt nur noch die letzte
Zeile aus.
Jetzt gibt es einen Token. env.sh neu laden und Forgejo
fragen, wer du als Bot bist:
source ~/renovate-lab/setup/env.sh
curl -s "$FORGEJO/api/v1/version"; echo
curl -s -H "Authorization: token $RENOVATE_TOKEN" "$FORGEJO/api/v1/user" \
| jq -c '{login, is_admin}'Erwartet:
{"version":"16.0.6+gitea-1.22.0"}
{"login":"renovate-bot","is_admin":false}
Die Token-Scopes (write:repository,
write:issue, read:user,
read:organization, read:package) reichen für
Branches, PRs, Issues und Presets. Die Weboberfläche erreichst du unter
http://127.0.0.1:3000 als lab-admin /
lab-admin-pw-123. Alles, was du dort klickst, geht im Buch
auch per curl oder git.
Sicherheit: Die Passwörter und das Token sind Lab-Werte. Die Datei
bot-tokengehört nie in ein Git-Repo.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Demo-Repo anlegen und Gelände prüfen
check.sh prüft das Gelände mit ✔/✘. Vor
seed.sh fehlt noch das Repo:
./check.sh | grep ✘Erwartet:
✘ Repo shop/shop-api vorhanden (sonst: seed.sh)
✘ Bot darf in shop/shop-api schreiben
seed.sh legt die Organisation shop an,
pusht den Inhalt von setup/shop-api als Repo
shop/shop-api und macht renovate-bot zum
Collaborator mit Schreibrecht:
./seed.sh
./check.sh | tail -3Erwartet:
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
✔ Bot-Token gültig (renovate-bot)
✔ Repo shop/shop-api vorhanden (sonst: seed.sh)
✔ Bot darf in shop/shop-api schreiben
Was liegt im Repo?
curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/contents" \
| jq -r '[.[].path] | join(" ")'
curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/raw/package.json" \
| jq -c '.dependencies, .devDependencies'Erwartet:
.github .gitignore Dockerfile README.md index.js package-lock.json package.json
{"express":"4.18.2","lodash":"^4.17.20"}
{"prettier":"3.0.0"}
Alles absichtlich veraltet: dazu
FROM node:20.11.0-alpine im Dockerfile und
actions/checkout@v3 in
.github/workflows/ci.yml. Futter für Renovate.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Erster Kontakt – nur lesen
Renovate kennt drei Dry-Run-Modi. Alle drei schreiben nichts nach Forgejo:
| Modus | Was Renovate tut | Netz |
|---|---|---|
extract |
klont das Repo, findet Abhängigkeiten | nur Forgejo |
lookup |
zusätzlich: sucht neue Versionen | Forgejo + Registries |
full |
zusätzlich: plant Branches und PRs | Forgejo + Registries |
cd ~/renovate-lab/tag00
renovate --dry-run=extract shop/shop-apiErwartet (gekürzt):
INFO: Renovate started
...
INFO: DRY-RUN: Would commit files to onboarding branch (repository=shop/shop-api)
INFO: Dependency extraction complete (repository=shop/shop-api, baseBranch=main)
"stats": {
"managers": {
"dockerfile": {"fileCount": 1, "depCount": 1},
"github-actions": {"fileCount": 1, "depCount": 4},
"npm": {"fileCount": 1, "depCount": 3}
},
"total": {"fileCount": 3, "depCount": 8}
}
INFO: Extracted dependencies (repository=shop/shop-api)
...
"depName": "express",
"currentValue": "4.18.2",
"datasource": "npm",
...
INFO: Repository finished (repository=shop/shop-api)
Drei Manager (dockerfile,
github-actions, npm) haben acht Abhängigkeiten
gefunden. Jede hat eine Datasource, bei der Renovate
später nach neuen Versionen fragt. github-actions zählt
vier, weil auch runs-on: ubuntu-latest und
node-version: 20 als Abhängigkeiten gelten. Details folgen
an Tag 3.
Would commit files to onboarding branch zeigt: Das Repo
ist noch nicht „onboarded”. Ein echter Lauf würde zuerst einen
Onboarding-PR öffnen (Tag 1). Mit LOG_LEVEL=debug siehst
du, wie Renovate zu diesem Schluss kommt:
LOG_LEVEL=debug renovate --dry-run=extract shop/shop-api 2>&1 \
| grep -E 'onboarded|Found [0-9]+ package|Would' | head -3Erwartet:
DEBUG: Repo is not onboarded (repository=shop/shop-api)
DEBUG: Found 3 package file(s) (repository=shop/shop-api)
INFO: DRY-RUN: Would commit files to onboarding branch (repository=shop/shop-api)
Prüf, dass wirklich nichts geschrieben wurde:
for e in branches pulls issues; do
echo "$e: $(curl -s -u "$ADMIN" \
"$FORGEJO/api/v1/repos/shop/shop-api/$e?state=all" | jq length)"
doneErwartet:
branches: 1
pulls: 0
issues: 0
Der eine Branch ist main. Kein
renovate/configure, kein PR, kein Issue.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Vorgeschmack – welche Updates gäbe es?
Ein lookup auf einem nicht onboardeten Repo bleibt beim
Onboarding stehen. Für den Blick nach vorn schaltest du das Onboarding
für diesen einen Lauf ab
(--onboarding=false --require-config=optional) und lässt
Renovate im JSON-Format loggen. Die Liste der Updates steht nur im
Debug-Log:
cd ~/renovate-lab/tag00
LOG_LEVEL=debug LOG_FORMAT=json \
renovate --dry-run=lookup --onboarding=false --require-config=optional \
shop/shop-api > lookup.json
jq -r 'select(.msg == "packageFiles with updates") | .config[][].deps[]
| [.depName, .currentValue, "->", (.updates[].newValue), .skipReason]
| map(values) | join(" ")' lookup.jsonErwartet (ohne GitHub-Token):
node 20.11.0-alpine -> 20.20.2-alpine 26.11.1-alpine
actions/checkout v3 -> github-token-required
actions/setup-node v3 -> github-token-required
ubuntu latest -> invalid-version
node 20 -> github-token-required
express 4.18.2 -> 4.22.3 5.3.0
lodash ^4.17.20 ->
prettier 3.0.0 -> 3.9.10
Die Zielversionen stammen vom Testlauf, bei dir sind sie neuer. Pro
Abhängigkeit gibt es meist ein Minor- und ein Major-Update
(express 4.22.3 und 5.3.0). lodash bekommt
keins: Der Bereich ^4.17.20 deckt die Version im Lockfile
schon ab.
Drei Einträge sind mit github-token-required
übersprungen, dazu steht im Log die Warnung
GitHub token is required for some dependencies. Renovate
fragt GitHub Actions und Node-Versionen bei github.com ab, und das
verlangt einen Token. Mit gh angemeldet reicht eine Zeile,
danach den Lookup wiederholen:
export RENOVATE_GITHUB_COM_TOKEN=$(gh auth token)
LOG_LEVEL=debug LOG_FORMAT=json \
renovate --dry-run=lookup --onboarding=false --require-config=optional \
shop/shop-api > lookup.json
jq -r 'select(.msg == "packageFiles with updates") | .config[][].deps[]
| [.depName, .currentValue, "->", (.updates[].newValue), .skipReason]
| map(values) | join(" ")' lookup.json | head -5Erwartet:
node 20.11.0-alpine -> 20.20.2-alpine 26.11.1-alpine
actions/checkout v3 -> v7
actions/setup-node v3 -> v7
ubuntu latest -> invalid-version
node 20 -> 24
Actions und Node-Version haben jetzt Ziele.
ubuntu-latest bleibt übersprungen: latest ist
keine Version, die Renovate vergleichen kann. Ohne Token laufen npm- und
Docker-Updates trotzdem, es fehlen nur GitHub-basierte Abhängigkeiten
und Release Notes.
Sicherheit:
gh auth tokenhat die Rechte deinergh-Anmeldung. Besser ist ein Fine-grained Token ohne Repository-Rechte. Der Token steht nur in der Umgebung, nie in einer Datei unter~/renovate-lab.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Reset und Abbau
Viele Tage brauchen einen frischen Stand von
shop/shop-api. --reset löscht das Repo samt
Branches, PRs und Issues und legt es neu an. User, Token und andere
Repos bleiben:
cd ~/renovate-lab/setup
./seed.sh --resetErwartet:
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
Nach einem Docker- oder Laptop-Neustart ist der Container gestoppt,
die Daten liegen aber in den Volumes. up.sh startet ihn
einfach wieder:
docker stop forgejo >/dev/null
./check.sh | grep -c ✘
./up.sh && ./check.sh | grep -c ✔Erwartet:
4
✔ Forgejo läuft: http://127.0.0.1:3000 (lab-admin / lab-admin-pw-123)
7
Kompletter Neubau mit frischer Datenbank: Container und Volumes löschen – und die Token-Datei, denn der alte Token gehört zur alten Datenbank:
docker rm -f forgejo
docker volume rm forgejo-data forgejo-conf
rm ~/renovate-lab/setup/bot-token
./up.sh && ./seed.sh
source ~/renovate-lab/setup/env.sh
./check.sh | grep -c ✔Erwartet:
forgejo
forgejo-data
forgejo-conf
New user 'lab-admin' has been successfully created!
New user 'renovate-bot' has been successfully created!
✔ Forgejo läuft: http://127.0.0.1:3000 (lab-admin / lab-admin-pw-123)
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
7
Achtung: Vergisst du
rm bot-token, erzeugtup.shkeinen neuen Token, undcheck.shmeldet✘ Bot-Token gültig. Ebenso wichtig:env.shneu laden, sonst steckt in deiner Shell noch der alte Wert vonRENOVATE_TOKEN.
Ganz am Ende des Buchs räumst du so auf:
docker rm -f forgejo,
docker volume rm forgejo-data forgejo-conf,
rm -rf ~/renovate-lab.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
source ~/renovate-lab/setup/env.sh
cd ~/renovate-lab/setup
for f in up.sh env.sh seed.sh mkrepo.sh check.sh bot-token; do
[ -s "$f" ] && echo "✔ $f vorhanden" || echo "✘ $f fehlt"
done
[ "$(renovate --version)" = 44.153.1 ] && echo "✔ Renovate 44.153.1" \
|| echo "✘ falsche Renovate-Version"
[ "$RENOVATE_PLATFORM" = forgejo ] && echo "✔ RENOVATE_PLATFORM=forgejo" \
|| echo "✘ env.sh nicht geladen"
n=$(curl -s -u "$ADMIN" "$FORGEJO/api/v1/repos/shop/shop-api/pulls?state=all" \
| jq length)
[ "$n" = 0 ] && echo "✔ noch keine PRs in shop/shop-api" \
|| echo "✘ $n PRs vorhanden"
./check.sh >/dev/null && echo "✔ check.sh ohne Fehler" \
|| echo "✘ check.sh meldet Fehler"Challenge
Ab Tag 1 willst du ständig wissen, was Renovate angelegt hat. Schreib
~/renovate-lab/tag00/status.sh [org/repo], das die offenen
PRs und Issues eines Repos (Standard shop/shop-api) mit
Nummer, Titel und Autor auflistet – nur per API, ohne Browser.
Hinweis: In Forgejo ist ein PR auch ein Issue; der
Endpunkt /issues filtert mit type=pulls bzw.
type=issues.
Lösung
Die Datei liegt auch unter
~/renovate-lab/code/tag00/status.sh.
cat > ~/renovate-lab/tag00/status.sh <<'EOF'
#!/usr/bin/env bash
# status.sh [org/repo] – listet offene PRs und Issues (Standard: shop/shop-api)
set -euo pipefail
source "${LAB:-$HOME/renovate-lab}/setup/env.sh"
REPO="${1:-shop/shop-api}"
for kind in pulls issues; do
json=$(curl -sf -u "$ADMIN" \
"$FORGEJO/api/v1/repos/$REPO/issues?state=open&type=$kind")
echo "== $kind: $(jq length <<<"$json") offen"
jq -r '.[] | "#\(.number) \(.title) (\(.user.login))"' <<<"$json"
done
EOF
chmod +x ~/renovate-lab/tag00/status.shZum Ausprobieren legst du als Admin ein Issue und einen PR an, schaust nach und setzt das Repo wieder zurück:
api() { curl -s -u "$ADMIN" -H 'Content-Type: application/json' "$@" >/dev/null; }
R="$FORGEJO/api/v1/repos/shop/shop-api"
api -X POST "$R/issues" -d '{"title":"Testissue vom Admin"}'
api -X POST "$R/branches" -d '{"new_branch_name":"test","old_branch_name":"main"}'
api -X PUT "$R/contents/x.txt" \
-d "{\"branch\":\"test\",\"content\":\"$(echo hi | base64)\",\"message\":\"x\"}"
api -X POST "$R/pulls" -d '{"title":"Test-PR","head":"test","base":"main"}'
~/renovate-lab/tag00/status.sh
~/renovate-lab/setup/seed.sh --resetErwartet:
== pulls: 1 offen
#2 Test-PR (lab-admin)
== issues: 1 offen
#1 Testissue vom Admin (lab-admin)
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Renovate läuft dort als geplanter Job (Tag 10); Node- und Renovate-Version sind gepinnt wie hier.
- Der Bot ist ein technischer Account mit minimalen Rechten (Tag 12), sein Token liegt im Secret-Store.
- Hinter Proxy oder ohne Internet braucht Renovate Zugriff auf
Registries oder interne Spiegel, sonst bleibt nur
extract. - Für github.com-Lookups: eigener Fine-grained Token ohne Repo-Rechte, nie der persönliche Token eines Menschen.
--dry-run=lookupzeigt beim Kunden den Update-Stau eines Repos, ohne einen PR.