Zum Inhalt springen
Trainingslager IT-Trainingslager

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-api loslassen. · 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-bot mit einem Token. Du selbst bist lab-admin und spielst den Menschen, der PRs mergt.
  • up.sh, seed.sh und check.sh bauen 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        # optional

Erwartet (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 -v

Erwartet (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-api

Erwartet:

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

Erwartet:

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

Erwartet:

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 (Image codeberg.org/forgejo/forgejo:16.0.6-rootless, SQLite, Volumes forgejo-data und forgejo-conf), falls er fehlt,
  • legt die User lab-admin (Admin) und renovate-bot (normaler User) an,
  • erzeugt einen Token für renovate-bot und schreibt ihn nach ~/renovate-lab/setup/bot-token (Rechte 600).
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-token gehö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 -3

Erwartet:

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

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

Erwartet:

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)"
done

Erwartet:

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

Erwartet (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 -5

Erwartet:

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 token hat die Rechte deiner gh-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 --reset

Erwartet:

✔ 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, erzeugt up.sh keinen neuen Token, und check.sh meldet ✘ Bot-Token gültig. Ebenso wichtig: env.sh neu laden, sonst steckt in deiner Shell noch der alte Wert von RENOVATE_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.sh

Zum 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 --reset

Erwartet:

== 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=lookup zeigt beim Kunden den Update-Stau eines Repos, ohne einen PR.