Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 9: Self-hosted betreiben

Ziel: Ein Bot mit globaler config.js betreut alle Repos einer Organisation, onboardet neue Repos mit eurem Standard und liefert auswertbare Logs. · Dauer: ca. 120 min · Voraussetzung: Tag 3

Briefing

  • Globale Config (Bot): config.js < RENOVATE_*-Env < CLI-Flags. Plattform, Token, Repo-Auswahl, Onboarding, Caches.
  • Repo-Config (renovate.json): darf nur Repo-Optionen enthalten.
  • autodiscover findet alle Repos, in denen der Bot schreiben darf; Filter grenzen ein.
  • Fehlt die Repo-Config, entscheiden onboarding und requireConfig.
  • Betrieb: JSON-Logs, Exit-Codes, persistenter cacheDir, Container.
 config.js ─┐
 RENOVATE_* ├─► globale Config ─► autodiscover + Filter ─► shop/a  shop/b  shop/c
 CLI-Flags ─┘                                                │
                          je Repo: renovate.json vorhanden? ─┤ ja   ─► Updates
                                                             └ nein ─► Onboarding-PR

Drill 1: Vier Repos, zwei Organisationen

Du setzt shop-api auf den Stand von Tag 0 zurück, legst shop-worker und shop-deploy aus Tag 3 neu an und baust eine zweite Organisation lager. In lager/lager-archiv nimmst du dem Bot das Schreibrecht.

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/tag09 && cd ~/renovate-lab/tag09
S=~/renovate-lab/setup; C=~/renovate-lab/code
$S/seed.sh --reset
$S/mkrepo.sh shop/shop-worker $C/tag03/shop-worker
$S/mkrepo.sh shop/shop-deploy $C/tag03/shop-deploy
$S/mkrepo.sh lager/lager-app $C/tag09/lager-app
$S/mkrepo.sh lager/lager-archiv $C/tag09/lager-app
cp $C/tag09/helpers.sh . && source helpers.sh
api -X DELETE "$FORGEJO/api/v1/repos/lager/lager-archiv/collaborators/renovate-bot" \
  && echo "✔ Bot aus lager/lager-archiv entfernt"

Erwartet (gekürzt):

✔ Bot darf in shop/shop-api schreiben
✔ Org shop, Repo shop/shop-api, Bot renovate-bot als Collaborator
✔ shop/shop-worker angelegt (http://127.0.0.1:3000/shop/shop-worker)
✔ shop/shop-deploy angelegt (http://127.0.0.1:3000/shop/shop-deploy)
✔ lager/lager-app angelegt (http://127.0.0.1:3000/lager/lager-app)
✔ lager/lager-archiv angelegt (http://127.0.0.1:3000/lager/lager-archiv)
✔ Bot aus lager/lager-archiv entfernt

helpers.sh bringt put (Datei per API committen), prs, raw, results und summary mit. shop-worker und shop-deploy haben eine renovate.json, shop-api und die lager-Repos nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Von Env-Variablen zur config.js

Bisher kam alles aus env.sh. Ein Dienst braucht eine Datei, die versioniert und reviewt wird. Renovate liest config.js aus dem aktuellen Verzeichnis, ein anderer Pfad geht über RENOVATE_CONFIG_FILE.

env | grep '^RENOVATE_' | cut -d= -f1 | sort
cat > config.js <<'EOF'
// config.js – globale Konfiguration des Lab-Bots (Tag 9)
module.exports = {
  platform: 'forgejo',
  endpoint: 'http://127.0.0.1:3000/api/v1',
  token: process.env.RENOVATE_TOKEN,      // Token nie in die Datei schreiben
  gitAuthor: 'Renovate Bot <[email protected]>',
  repositories: ['shop/shop-worker'],
};
EOF
unset RENOVATE_PLATFORM RENOVATE_ENDPOINT RENOVATE_GIT_AUTHOR
renovate-config-validator config.js
renovate --dry-run=extract 2>&1 | grep -E 'Repository (started|finished)|durationMs'

Erwartet:

RENOVATE_ENDPOINT
RENOVATE_GIT_AUTHOR
RENOVATE_GITHUB_COM_TOKEN
RENOVATE_PLATFORM
RENOVATE_TOKEN
 INFO: Validating config.js as global config
 INFO: Config validated successfully against 1 file(s)
 INFO: Repository started (repository=shop/shop-worker)
 INFO: Repository finished (repository=shop/shop-worker)
       "durationMs": 1898,

Ohne Repo-Argument nimmt Renovate repositories aus der Datei. Mit Dateiargument prüft der Validator immer als globale Config. Jetzt die Rangfolge:

RENOVATE_REPOSITORIES=shop/shop-deploy renovate --dry-run=extract 2>&1 \
  | grep -E 'Repository started|WARN'
RENOVATE_REPOSITORIES=shop/shop-deploy renovate --dry-run=extract shop/shop-api 2>&1 \
  | grep -E 'Repository started|CLI config'
mv config.js bot.config.js
RENOVATE_CONFIG_FILE=bot.config.js renovate --dry-run=extract 2>&1 \
  | grep 'Repository started'
RENOVATE_CONFIG_FILE=fehlt.js renovate 2>&1 | grep FATAL; echo "exit=${pipestatus[1]}"
mv bot.config.js config.js

Erwartet:

 INFO: Repository started (repository=shop/shop-deploy)
 WARN: CLI config is overridding the `repositories` config previously set
 INFO: Repository started (repository=shop/shop-api)
 INFO: Repository started (repository=shop/shop-worker)
FATAL: Custom config file specified in RENOVATE_CONFIG_FILE must exist
exit=1

Env schlägt Datei, CLI schlägt beides. Das stammt aus parseConfigs(): Renovate mischt erst Datei, dann Env, dann CLI. exit=${pipestatus[1]} gilt für zsh, in bash heißt es ${PIPESTATUS[0]}.

Achtung: Jede neue Shell mit source env.sh setzt RENOVATE_ENDPOINT und Co. wieder und überstimmt damit die Datei. In einem Dienst setzt du nur RENOVATE_TOKEN als Env, alles andere steht in config.js.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Global- vs. Repo-Optionen

Optionen mit globalOnly wirken nur in der Bot-Config. Einige davon:

Bereich Nur global
Plattform platform, endpoint, token, username, gitUrl
Repo-Auswahl repositories, autodiscover, autodiscoverFilter, …Namespaces
Onboarding onboarding, onboardingConfig, onboardingBranch, requireConfig
Betrieb baseDir, cacheDir, repositoryCache, persistRepoData, dryRun
Sicherheit allowedCommands, allowedEnv, secrets, exposeAllEnv

Die vollständige Liste liefert das Feld globalOnly in tools/node_modules/renovate/dist/config/options/index.js. Was passiert, wenn so eine Option in renovate.json landet?

mkdir -p repo-cfg && cat > repo-cfg/renovate.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": ["config:recommended"],
  "requireConfig": "optional",
  "repositoryCache": "enabled"
}
EOF
(cd repo-cfg && renovate-config-validator 2>&1 | grep -o '"The .* global option')
(cd repo-cfg && renovate-config-validator >/dev/null 2>&1; echo "exit=$?")
put shop/shop-worker renovate.json repo-cfg/renovate.json "Globale Optionen im Repo"
renovate > global.log 2>&1; echo "exit=$?"
grep -E '^ WARN|"result"' global.log
put shop/shop-worker renovate.json ~/renovate-lab/code/tag03/shop-worker/renovate.json \
  "Nur Repo-Optionen"

Erwartet:

"The \"repositoryCache\" option is a global option
"The \"requireConfig\" option is a global option
exit=1
✔ renovate.json @ 184553c
exit=0
 WARN: Found renovate config warnings (repository=shop/shop-worker)
       "result": "done",
✔ renovate.json @ 0d43ad6

Der Validator meldet einen Fehler (Exit 1). Der echte Lauf ignoriert die beiden Optionen nur, warnt und arbeitet weiter. Im Dependency Dashboard von shop-worker steht unter „Repository Problems”: ⚠️ WARN: Found renovate config warnings. Danach stellst du die saubere Config wieder her.

Fortschritt speichern? Kostenlos registrieren

Drill 4: autodiscover und Filter

Statt einer Repo-Liste fragt Renovate die Plattform. Bei Forgejo sucht es Repos, auf die der Bot-User Zugriff hat, und verwirft alle ohne Push-Recht.

curl -s -H "Authorization: token $RENOVATE_TOKEN" \
  "$FORGEJO/api/v1/repos/search?limit=50" \
  | jq -r '.data[] | "\(.full_name)  push=\(.permissions.push)"'
renovate --autodiscover --write-discovered-repos=repos.json >/dev/null 2>&1
cat repos.json; echo

Erwartet:

lager/lager-app  push=true
lager/lager-archiv  push=false
shop/shop-api  push=true
shop/shop-deploy  push=true
shop/shop-worker  push=true
["lager/lager-app","shop/shop-api","shop/shop-deploy","shop/shop-worker"]

lager-archiv ist öffentlich und damit sichtbar, fehlt aber: kein Collaborator, kein Push. --write-discovered-repos schreibt die Liste und beendet Renovate, ohne ein Repo anzufassen. Ideal zum Testen von Filtern:

for f in 'shop/*' '/^lager\//' '!shop/shop-deploy' 'shop/shop-{api,worker}'; do
  renovate --autodiscover --autodiscover-filter="$f" \
    --write-discovered-repos=repos.json >/dev/null 2>&1
  printf '%-24s %s\n' "$f" "$(cat repos.json)"
done

Erwartet:

shop/*                   ["shop/shop-api","shop/shop-deploy","shop/shop-worker"]
/^lager\//               ["lager/lager-app"]
!shop/shop-deploy        ["lager/lager-app","shop/shop-api","shop/shop-worker"]
shop/shop-{api,worker}   ["shop/shop-worker"]

Glob, /Regex/ und !-Negation funktionieren wie bei matchPackageNames (Tag 2). Die letzte Zeile ist eine Falle: Auf der Kommandozeile trennt Renovate Listen am Komma, aus dem Glob werden zwei kaputte Muster. In config.js geht {api,worker}. Mehrere Muster wirken zusammen: ['*/*', '!lager/*'] heißt „alles außer lager”.

Achtung: autodiscoverNamespaces: ['lager'] listet die Org-Repos direkt und prüft dabei keine Push-Rechte. Im Lab taucht lager/lager-archiv dann wieder auf. Bei aktivem autodiscover sind Repo-Argumente auf der Kommandozeile übrigens kein Filter: Renovate bearbeitet trotzdem alle gefundenen Repos.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Onboarding mit Org-Standard

Ohne onboardingConfig schreibt der Onboarding-PR nur $schema (Tag 1). Jetzt gibt der Bot den Standard vor. Ab hier ersetzt diese config.js die aus Drill 2.

cat > config.js <<'EOF'
// config.js – globale Konfiguration des Lab-Bots (Tag 9)
module.exports = {
  platform: 'forgejo',
  endpoint: 'http://127.0.0.1:3000/api/v1',
  token: process.env.RENOVATE_TOKEN,      // Token nie in die Datei schreiben
  gitAuthor: 'Renovate Bot <[email protected]>',
  autodiscover: true,
  autodiscoverFilter: ['shop/*'],
  onboardingBranch: 'renovate/onboarding',
  onboardingConfig: {
    $schema: 'https://docs.renovatebot.com/renovate-schema.json',
    extends: ['config:recommended', ':timezone(Europe/Berlin)'],
  },
};
EOF
renovate-config-validator config.js | tail -1
renovate > onboarding.log 2>&1; echo "exit=$?"
results onboarding.log
prs shop/shop-api
raw shop/shop-api renovate/onboarding renovate.json

Erwartet:

 INFO: Config validated successfully against 1 file(s)
exit=0
shop/shop-api   onboarding
shop/shop-deploy    done
shop/shop-worker    done
#1 open renovate/onboarding | Configure Renovate
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
    "config:recommended",
    ":timezone(Europe/Berlin)"
  ]
}

Nur shop-api hat keine Config und bekommt den Onboarding-PR, jetzt auf dem Branch renovate/onboarding und mit eurem Standard. Die anderen beiden sind schon onboardet und bekommen Update-PRs. In Tag 11 zeigt extends stattdessen auf ein Preset-Repo (local>shop/renovate-config), dann ändert sich der Standard zentral.

Fortschritt speichern? Kostenlos registrieren

Drill 6: requireConfig und Repos abschalten

Zwei Wege, ein Repo stillzulegen: den Onboarding-PR schließen oder in der Config "enabled": false setzen.

api -X PATCH "$FORGEJO/api/v1/repos/shop/shop-api/pulls/1" -d '{"state":"closed"}' \
  | jq -r '"#\(.number) \(.state)"'
cat > aus.json <<'EOF'
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "enabled": false
}
EOF
put shop/shop-deploy renovate.json aus.json "Renovate abschalten"
renovate > aus.log 2>&1; results aus.log
api "$FORGEJO/api/v1/repos/shop/shop-api/issues/1/comments" | jq -r '.[].body' \
  | cut -c1-88 | head -3

Erwartet:

#1 closed
✔ renovate.json @ 1e2f12f
shop/shop-api   disabled-closed-onboarding
shop/shop-deploy    disabled-by-config
shop/shop-worker    done
### Renovate is disabled

Renovate is disabled because there is no Renovate configuration file. To enable Renovate

Wie verbindlich die Repo-Config ist, regelt requireConfig:

Wert Repo ohne Config Config im Repo
required (Default) Onboarding-PR; mit onboarding: false übersprungen gilt
optional läuft mit globaler Config (nach geschlossenem PR!) gilt
ignored läuft mit globaler Config wird nicht gelesen

Probier beide anderen Werte als Trockenlauf per Env:

for rc in optional ignored; do
  RENOVATE_REQUIRE_CONFIG=$rc renovate --dry-run=full > rc-$rc.log 2>&1
  echo "== requireConfig=$rc"; results rc-$rc.log
  grep -c 'Would commit files' rc-$rc.log
done

Erwartet:

== requireConfig=optional
shop/shop-api   done
shop/shop-deploy    disabled-by-config
shop/shop-worker    done
8
== requireConfig=ignored
shop/shop-api   done
shop/shop-deploy    done
shop/shop-worker    done
8

Zwei Überraschungen. Mit optional zählt der geschlossene Onboarding-PR nicht mehr: shop-api bekäme acht Branches, und zwar nur mit Renovates Defaults, weil die globale Config kein extends hat. Mit ignored übergeht der Bot sogar "enabled": false. Setze beide nur bewusst und sag es den Teams.

Fortschritt speichern? Kostenlos registrieren

Drill 7: JSON-Logs, Laufzusammenfassung, Exit-Codes

Für einen Dienst willst du maschinenlesbare Logs. LOG_FORMAT=json schaltet stdout auf eine JSON-Zeile pro Eintrag (bunyan), LOG_FILE schreibt zusätzlich eine Datei mit eigenem Level LOG_FILE_LEVEL (Default debug).

LOG_FORMAT=json renovate > lauf.json 2>&1
head -1 lauf.json | jq -c '{level, msg, time}'
summary lauf.json
mkdir -p logs
LOG_FILE=logs/renovate.ndjson LOG_FILE_LEVEL=debug renovate > lauf.txt 2>&1
wc -l < lauf.txt; jq -r .level logs/renovate.ndjson | sort | uniq -c

Erwartet:

{"level":30,"msg":"Renovate started","time":"2026-10-12T16:31:06.433Z"}
shop/shop-api   481 ms  cloned=true disabled-closed-onboarding
shop/shop-deploy    387 ms  cloned=true disabled-by-config
shop/shop-worker    2162 ms cloned=true done
      47
 537 20
  16 30

Levels: 20 debug, 30 info, 40 warn, 50 error, 60 fatal. Die Konsole bleibt bei info (47 Zeilen), die Datei hat alle 553 Einträge. summary liest pro Repo den Eintrag „Repository finished”. Ohne LOG_FORMAT sieht er so aus:

 INFO: Repository finished (repository=shop/shop-worker)
       "cloned": true,
       "durationMs": 1558,
       "result": "done",
       "status": "onboarded",
       "enabled": true,
       "onboarded": true,
       "exitCode": 0

Und die Exit-Codes? Gib lager/lager-app eine kaputte Config und schau hin. --autodiscover=false mit Repo-Argument überstimmt config.js für diesen Aufruf.

printf '{\n  "extends": ["config:recommended",]\n' > kaputt.json
put lager/lager-app renovate.json kaputt.json "Kaputte Config"
renovate --autodiscover=false lager/lager-app >x.log 2>&1; echo "exit=$?"
renovate --autodiscover=false --exit-code-for-errors=true lager/lager-app >x.log 2>&1
echo "exit=$?"
renovate --autodiscover=false shop/gibtsnicht >x.log 2>&1; echo "exit=$?"

Erwartet:

✔ renovate.json @ a43b960
exit=0
exit=5
exit=1
Exit Bedeutung
0 fertig, auch wenn ein Repo eine kaputte Config hat (Issue im Repo)
1 FATAL beim Start oder ein Log-Eintrag mit Level ERROR
3–8 nur mit exitCodeForErrors: true: 3 System, 4 Plattform, 5 Config, … 8 unbekannt

Ohne exitCodeForErrors merkt dein CronJob also nichts von einer kaputten Repo-Config. In lager/lager-app liegt dafür das Issue „Action Required: Fix Renovate Configuration”.

Fortschritt speichern? Kostenlos registrieren

Drill 8: baseDir, cacheDir und Repository-Cache

Renovate arbeitet in baseDir (Default $TMPDIR/renovate): Klone unter repos/, Caches unter cache/ (= cacheDir). Mit repositoryCache: "enabled" merkt es sich pro Repo zusätzlich Extraktion, Branches und PRs. Miss drei Läufe:

export RENOVATE_BASE_DIR=~/renovate-lab/tag09/work LOG_FORMAT=json
put shop/shop-deploy renovate.json ~/renovate-lab/code/tag03/shop-deploy/renovate.json \
  "Renovate wieder an"
rm -rf work
for i in 1 2; do
  LOG_FILE=logs/cache$i.ndjson renovate --repository-cache=enabled > cache$i.json 2>&1
  echo "-- Lauf $i"; summary cache$i.json
done
echo "-- Lauf 3 (ohne Repo-Cache)"; renovate > cache3.json 2>&1; summary cache3.json

Erwartet:

✔ renovate.json @ 1a5ba53
-- Lauf 1
shop/shop-api   649 ms  cloned=true disabled-closed-onboarding
shop/shop-deploy    20716 ms    cloned=true done
shop/shop-worker    4784 ms cloned=true done
-- Lauf 2
shop/shop-api   384 ms  cloned=true disabled-closed-onboarding
shop/shop-deploy    3203 ms cloned=true done
shop/shop-worker    1086 ms cloned=true done
-- Lauf 3 (ohne Repo-Cache)
shop/shop-api   479 ms  cloned=true disabled-closed-onboarding
shop/shop-deploy    3919 ms cloned=true done
shop/shop-worker    2265 ms cloned=true done

Summiert: 26,1 s kalt, 4,7 s warm mit Repo-Cache, 6,7 s warm ohne. Den großen Sprung macht der Paket-Cache in cacheDir (Datasource-Antworten), den Rest der Repository-Cache (work/cache/renovate/repository/forgejo/shop/*.json). Woran du ihn erkennst:

jq -r 'select(.msg | startswith("Cached extract")) | "\(.repository): \(.msg)"' \
  logs/cache2.ndjson | cut -c1-88

Erwartet:

shop/shop-deploy: Cached extract for sha=1a5ba53e57f7f59dca653f92f9b8ec2157416ced is val
shop/shop-worker: Cached extract for sha=0d43ad6ba4a9751bf5f54dc616b357564039d1bc is val

Hat sich main nicht bewegt, überspringt Renovate die Extraktion. work/repos bleibt leer, weil Renovate den Klon nach jedem Repo löscht. persistRepoData behält ihn:

for i in 1 2; do
  LOG_FILE=logs/persist$i.ndjson renovate --repository-cache=enabled \
    --persist-repo-data=true > p$i.json 2>&1
done
for i in 1 2; do jq -r 'select(.msg | test("(clone|fetch) completed")) | .msg' \
  logs/persist$i.ndjson | sort | uniq -c; done

Erwartet:

   3 git clone completed
   3 git fetch completed

Bei den Lab-Repos bringt fetch statt clone kaum Zeit. Bei großen Monorepos lohnt es sich, kostet aber dauerhaft Platz pro Repo. Für den Rest des Tages: unset LOG_FORMAT.

Tipp: Im Container oder CronJob ist /tmp nach jedem Lauf weg. Ohne persistentes Volume für cacheDir ist jeder Lauf ein Kaltstart wie Lauf 1 (Tag 10).

Fortschritt speichern? Kostenlos registrieren

Drill 9: Das offizielle Docker-Image

Produktiv läuft Renovate meist als Container ghcr.io/renovatebot/renovate. Prüfe erst die Größe, ohne das Image zu ziehen:

IMG=ghcr.io/renovatebot/renovate:44.153.1
ARCH=$(uname -m | sed 's/x86_64/amd64/; s/aarch64/arm64/')
D=$(docker manifest inspect $IMG | jq -r --arg a "$ARCH" \
  '.manifests[] | select(.platform.architecture == $a) | .digest')
docker manifest inspect ghcr.io/renovatebot/renovate@$D \
  | jq -r '[.layers[].size] | add / 1024 / 1024 | floor | "\(.) MiB komprimiert"'

Erwartet:

405 MiB komprimiert

Entpackt braucht es ein Mehrfaches. Die Variante 44.153.1-full mit allen Werkzeugen (go, helm, …) hat komprimiert 2454 MiB. Das Image läuft als User 12021 im Verzeichnis /usr/src/app, dort sucht es config.js.

Das eigentliche Problem ist das Netz: Im Container ist 127.0.0.1 der Container selbst. Teste die Wege mit dem Forgejo-Image, das du schon hast (es enthält git):

I=codeberg.org/forgejo/forgejo:16.0.6-rootless
for net in bridge host; do for h in 127.0.0.1 host.docker.internal; do
  printf '%-7s %-22s ' $net $h
  docker run --rm --network "$net" --entrypoint git $I \
    ls-remote "http://$h:3000/shop/shop-api.git" main >/dev/null 2>&1 \
    && echo "✔ erreichbar" || echo "✘ keine Verbindung"
done; done

Erwartet (Colima auf macOS):

bridge  127.0.0.1              ✘ keine Verbindung
bridge  host.docker.internal   ✔ erreichbar
host    127.0.0.1              ✔ erreichbar
host    host.docker.internal   ✔ erreichbar

Unter Colima ist --network host das Netz der Linux-VM, in der Forgejo seinen Port veröffentlicht. Darum klappt es hier, anders als oft behauptet. Unter Docker Desktop hängt das Verhalten von Version und Einstellung ab. host.docker.internal geht in beiden Fällen und ist der portable Weg.

Eine Falle bleibt: Forgejo meldet als Clone-URL seine ROOT_URL, also http://127.0.0.1:3000/.... Mit gitUrl: "endpoint" baut Renovate die Clone-URL aus dem endpoint. Das kannst du lokal beweisen:

for g in default endpoint; do
  LOG_LEVEL=debug RENOVATE_ENDPOINT=http://localhost:3000/api/v1 RENOVATE_GIT_URL=$g \
    renovate --autodiscover=false --dry-run=extract shop/shop-worker 2>&1 \
    | grep -E 'Using HTTP URL|using URL based|"url": "http.*\.git"' | cut -c1-88
done

Erwartet:

DEBUG: Using HTTP URL: http://127.0.0.1:3000/shop/shop-worker.git (repository=shop/shop-
DEBUG: using URL based on configured endpoint (repository=shop/shop-worker)
       "url": "http://**redacted**@localhost:3000/shop/shop-worker.git"

Der Container-Lauf nimmt config.js aus Drill 5 und überstimmt Endpoint und gitUrl per Env:

docker run --rm \
  -e RENOVATE_TOKEN -e RENOVATE_GITHUB_COM_TOKEN -e LOG_FORMAT=json \
  -e RENOVATE_ENDPOINT=http://host.docker.internal:3000/api/v1 \
  -e RENOVATE_GIT_URL=endpoint \
  -v "$PWD/config.js:/usr/src/app/config.js:ro" \
  ghcr.io/renovatebot/renovate:44.153.1 > docker.json
summary docker.json
docker rmi ghcr.io/renovatebot/renovate:44.153.1

Erwartet (nicht live getestet, kann je nach Version abweichen): eine Zeile pro shop-Repo wie bei summary in Drill 7, mit Laufzeiten wie Lauf 1 aus Drill 8, denn der Cache im Container ist leer. Der Pull braucht entpackt gut 1 GB auf der Docker-Disk: vorher docker system df prüfen, danach das Image löschen. Ein beschreibbares Cache-Volume für den Container-User baust du in Tag 10.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

Das Skript liegt auch unter code/tag09/kontrolle.sh.

cd ~/renovate-lab/tag09 && source ~/renovate-lab/setup/env.sh
cat > kontrolle.sh <<'EOF'
unset RENOVATE_PLATFORM RENOVATE_ENDPOINT RENOVATE_GIT_AUTHOR RENOVATE_CONFIG_FILE
source ./helpers.sh
ok() { if eval "$2" >/dev/null 2>&1; then echo "✔ $1"; else echo "✘ $1"; fi; }
ok "config.js ist gültige globale Config" "renovate-config-validator config.js"
ok "kein Token im Klartext in config.js" \
  "grep -q 'process.env.RENOVATE_TOKEN' config.js && ! grep -qE \"token: '\" config.js"
renovate --write-discovered-repos=k.json >/dev/null 2>&1
ok "autodiscover findet shop, aber nicht lager" \
  "jq -e 'any(startswith(\"shop/\")) and all(startswith(\"lager/\") | not)' k.json"
ok "Onboarding-PR in shop-api geschlossen" \
  "prs shop/shop-api closed | grep -q 'renovate/onboarding'"
ok "shop-deploy wieder aktiv (kein enabled: false)" \
  "! raw shop/shop-deploy main renovate.json | grep -q '\"enabled\": false'"
ok "Repository-Cache liegt im baseDir" \
  "ls work/cache/renovate/repository/forgejo/shop/*.json"
ok "JSON-Log enthält Laufzusammenfassung" "summary cache1.json | grep -q ms"
EOF
bash kontrolle.sh

Erwartet:

✔ config.js ist gültige globale Config
✔ kein Token im Klartext in config.js
✔ autodiscover findet shop, aber nicht lager
✔ Onboarding-PR in shop-api geschlossen
✔ shop-deploy wieder aktiv (kein enabled: false)
✔ Repository-Cache liegt im baseDir
✔ JSON-Log enthält Laufzusammenfassung

Challenge

Schreib challenge.config.js für den Org-Bot: autodiscover über alle Repos außer der Org lager, Repo-Config Pflicht, Onboarding auf renovate/onboarding mit dem Standard config:recommended, Zeitzone Berlin und Updates nur montags früh, Repository-Cache an, Exit-Code bei Repo-Fehlern. Ein neues Repo shop/shop-katalog muss den Onboarding-PR mit genau diesem Standard bekommen.

Hinweis: Ein Positiv- und ein Negativmuster in autodiscoverFilter, und schedule:earlyMondays ist ein fertiges Preset.

Lösung

cd ~/renovate-lab/tag09 && source helpers.sh
cat > challenge.config.js <<'EOF'
// challenge.config.js – Org-Bot nur für shop (Tag 9, Challenge)
module.exports = {
  platform: 'forgejo',
  endpoint: 'http://127.0.0.1:3000/api/v1',
  token: process.env.RENOVATE_TOKEN,
  gitAuthor: 'Renovate Bot <[email protected]>',
  autodiscover: true,
  autodiscoverFilter: ['*/*', '!lager/*'],
  requireConfig: 'required',
  onboardingBranch: 'renovate/onboarding',
  onboardingConfig: {
    $schema: 'https://docs.renovatebot.com/renovate-schema.json',
    extends: [
      'config:recommended',
      ':timezone(Europe/Berlin)',
      'schedule:earlyMondays',
    ],
  },
  repositoryCache: 'enabled',
  exitCodeForErrors: true,
};
EOF
~/renovate-lab/setup/mkrepo.sh shop/shop-katalog ~/renovate-lab/code/tag09/lager-app
renovate-config-validator challenge.config.js | tail -1
export RENOVATE_CONFIG_FILE=$PWD/challenge.config.js
renovate --write-discovered-repos=repos.json >/dev/null 2>&1; cat repos.json; echo
renovate > challenge.log 2>&1; echo "exit=$?"; results challenge.log
prs shop/shop-katalog
raw shop/shop-katalog renovate/onboarding renovate.json | jq -c .extends
unset RENOVATE_CONFIG_FILE

Erwartet:

✔ shop/shop-katalog angelegt (http://127.0.0.1:3000/shop/shop-katalog)
 INFO: Config validated successfully against 1 file(s)
["shop/shop-api","shop/shop-deploy","shop/shop-katalog","shop/shop-worker"]
exit=0
shop/shop-api   disabled-closed-onboarding
shop/shop-deploy    done
shop/shop-katalog   onboarding
shop/shop-worker    done
#1 open renovate/onboarding | Configure Renovate
["config:recommended",":timezone(Europe/Berlin)","schedule:earlyMondays"]

requireConfig: 'required' ist der Default, explizit dokumentiert er aber die Absicht. Exit 0 trotz exitCodeForErrors: Ein abgeschaltetes Repo ist kein Fehler. lager/lager-app mit seiner kaputten Config bleibt außen vor. Das Schedule-Preset wirkt erst nach dem Merge des Onboarding-PRs.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Ein Bot-Account pro Mandant oder Org-Gruppe. Was der Bot nicht schreiben darf, findet autodiscover nicht. Das ist eure eigentliche Zugriffskontrolle, Filter sind nur die zweite Linie.
  • config.js gehört ins Git und ins Review, Tokens nie: process.env plus Secret aus Vault, Kubernetes-Secret oder CI-Variable (Tag 10, Tag 12).
  • cacheDir auf ein persistentes Volume. Bei mehreren parallelen Instanzen den Paket-Cache in Redis (redisUrl) und den Repository-Cache in S3 (repositoryCacheType) auslagern.
  • JSON-Logs ins zentrale Logging, Alarm auf exitCodeForErrors ungleich 0 und auf „Repository finished” mit result außerhalb von done/onboarding/disabled-*.
  • Image per Tag und Digest pinnen und selbst von Renovate aktualisieren lassen. Die -full-Variante nur, wenn Lockfiles Werkzeuge brauchen, die nicht nachinstallierbar sind (binarySource).