Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 3: Katalog füllen und pflegen

Ziel: Den Katalog aus Konfiguration, Sammel-Locations und automatischer Repo-Discovery füllen und Fehler, Waisen und Löschungen sicher beherrschen. · Dauer: ca. 90 min · Voraussetzung: Tag 2

Briefing

  • Jede Entity stammt aus einer Location. Locations kommen aus drei Quellen: per API/GUI registriert (Tag 1), statisch aus catalog.locations oder von einem Entity-Provider wie dem Gitea-Provider.
  • Der Katalog verarbeitet alles in Schleifen: lesen, prüfen (catalog.rules), speichern. Fehler landen an der Entity, nicht im Terminal des Autors.
  • Verschwindet eine Entity aus ihrer Quelle, wird sie zum Orphan.
  • Vorausgesetzt: Portal läuft, Repos kranich/sendungs-api, kranich/tracking-web und kranich/sendungsverfolgung sind per API registriert, catalog.rules aus Tag 2 erlaubt zusätzlich Domain.
 app-config.local.yaml            Forgejo (kranich/*)
 ┌──────────────────────┐         ┌──────────────────────────────┐
 │ catalog.locations ───┼────────►│ katalog/locations.yaml       │
 │                      │         │   └─ extern/*.yaml           │
 │ catalog.providers    │  1/min  │ sendungs-api/catalog-info    │
 │   gitea.kranich ─────┼────────►│ tracking-web/catalog-info    │
 └──────────────────────┘         │ sendungsverfolgung/…  …      │
 POST /api/catalog/locations      └──────────────────────────────┘
   (Tag 1/2, wird heute abgelöst)

Drill 1: Woher kommt eine Entity?

source ~/backstage-lab/setup/env.sh
mkdir -p ~/backstage-lab/tag03
bs catalog/locations | jq -r '.[].data | "\(.type)  \(.target)"'

Erwartet:

url  http://127.0.0.1:3300/kranich/sendungs-api/src/branch/main/catalog-info.yaml
url  http://127.0.0.1:3300/kranich/tracking-web/src/branch/main/catalog-info.yaml
url  http://127.0.0.1:3300/kranich/sendungsverfolgung/src/branch/main/catalog-info.yaml

/locations zeigt nur die per API oder Register Existing Component angelegten Locations – die Beispieldaten aus app-config.yaml fehlen. Die Herkunft jeder Entity steht in ihren Annotations, die Kette dorthin liefert ancestry:

bs catalog/entities/by-name/component/default/tracking-web \
  | jq '.metadata.annotations | with_entries(select(.key | test("managed-by")))'
bs catalog/entities/by-name/component/default/tracking-web/ancestry \
  | jq -r '.items[] | "\(.entity.kind):\(.entity.metadata.name)"'

Erwartet (gekürzt):

{
  "backstage.io/managed-by-location": "url:http://127.0.0.1:3300/kranich/tracking-web…",
  "backstage.io/managed-by-origin-location": "url:http://127.0.0.1:3300/kranich/track…"
}
Component:tracking-web
Location:generated-312510c429b29856fc16cb8e02bb87db6e1c7ad3

Im Browser:

  1. http://localhost:3000/catalog/default/component/tracking-web öffnen.
  2. Oben rechts auf ⋮ klicken.

Erwartet: das Menü mit Unregister entity, Inspect entity und Copy entity URL.

Das Kontextmenü einer Entity
  1. Inspect entity wählen, dann den Reiter Ancestry.

Erwartet: Über tracking-web hängt eine Location generated-…, die der Katalog bei der Registrierung erzeugt hat.

Entity Inspector mit der Ancestry von tracking-web

Warum? Ancestry ist die Verarbeitungskette (wer hat wen erzeugt), nicht die Relationen aus Tag 2. Raw YAML zeigt die Entity so, wie der Katalog sie gespeichert hat – inklusive aller vom Katalog ergänzten Annotations.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Sammel-Location im Repo kranich/katalog

Externe Dienste haben kein eigenes Repo. Sie landen als einzelne Dateien in einem Katalog-Repo, eine Location-Entität mit spec.targets sammelt sie ein:

cp -R ~/backstage-lab/code/tag03/katalog ~/backstage-lab/tag03/katalog
cat ~/backstage-lab/tag03/katalog/locations.yaml
cat ~/backstage-lab/tag03/katalog/extern/paketdienst.yaml

Erwartet:

apiVersion: backstage.io/v1alpha1
kind: Location
metadata:
  name: kranich-extern
  description: Externe Dienste ohne eigenes Repo
spec:
  targets:
    - ./extern/paketdienst.yaml
    - ./extern/kartendienst.yaml
apiVersion: backstage.io/v1alpha1
kind: Resource
metadata:
  name: paketdienst
  description: Externer Paketdienst (SaaS), liefert Zustellereignisse
  links:
    - url: https://status.paketdienst.example
      title: Statusseite
spec:
  type: external-service
  owner: team-sendung
  system: sendungsverfolgung

kartendienst.yaml ist analog (Owner team-web). Relative targets lösen sich relativ zur Datei locations.yaml auf. Bewusst heißt die Datei nicht catalog-info.yaml – warum, siehst du in Drill 4.

~/backstage-lab/setup/mkrepo.sh kranich/katalog ~/backstage-lab/tag03/katalog

Erwartet:

✔ kranich/katalog angelegt (http://127.0.0.1:3300/kranich/katalog)

Jetzt die Location statisch in die Konfiguration. Die Datei wird komplett neu geschrieben (Stand Tag 2 plus Block locations):

cat > ~/backstage-lab/portal/app-config.local.yaml <<'EOF'
app:
  title: Kranich Entwicklerportal
organization:
  name: Kranich Logistik
backend:
  auth:
    externalAccess:
      - type: static
        options:
          token: ${BACKSTAGE_TOKEN}
          subject: lab-cli
  database:
    client: better-sqlite3
    connection:
      directory: ${LAB}/data
integrations:
  gitea:
    - host: 127.0.0.1:3300
      baseUrl: http://127.0.0.1:3300
      username: backstage-bot
      password: ${FORGEJO_TOKEN}
catalog:
  rules:
    - allow: [Component, System, API, Resource, Location, Domain]
  locations:
    # Beispieldaten aus create-app (Arrays werden ersetzt, nicht ergänzt!)
    - type: file
      target: ../../examples/entities.yaml
    - type: file
      target: ../../examples/template/template.yaml
      rules:
        - allow: [Template]
    - type: file
      target: ../../examples/org.yaml
      rules:
        - allow: [User, Group]
    # Sammel-Location im Repo kranich/katalog
    - type: url
      target: http://127.0.0.1:3300/kranich/katalog/src/branch/main/locations.yaml
EOF
~/backstage-lab/setup/portal.sh restart

Erwartet:

✔ gestoppt
✔ Backstage läuft: http://localhost:3000 (Backend http://localhost:7007)

Ab hier lasse ich die beiden ✔-Zeilen von portal.sh restart in den erwarteten Ausgaben weg.

Achtung: Backstage führt Konfigurationsdateien zusammen, Listen aber nicht: catalog.locations aus app-config.local.yaml ersetzt die Liste aus app-config.yaml vollständig. Ohne die drei examples-Einträge wären die Beispieldaten nach dem Neustart weg.

bs 'catalog/entities?filter=kind=resource' | jq -r '.[] | [.metadata.name,
  .metadata.annotations["backstage.io/managed-by-location"]] | @tsv'

Erwartet:

kartendienst    url:http://127.0.0.1:3300/kranich/katalog/src/branch/main/extern/karte…
paketdienst url:http://127.0.0.1:3300/kranich/katalog/src/branch/main/extern/paket…
sendungs-db url:http://127.0.0.1:3300/kranich/sendungsverfolgung/src/branch/main/ca…

Im Browser http://localhost:3000/?filters[kind]=resource öffnen. Erwartet: drei Resources, zwei davon aus dem Katalog-Repo.

Katalog gefiltert auf Resources

Fortschritt speichern? Kostenlos registrieren

Drill 3: Lokale Datei und catalog.rules

type: file liest vom Dateisystem des Backends – praktisch zum Ausprobieren. Relative Pfade gelten ab packages/backend, ${LAB} setzt env.sh. Im Entwurf steht die fehlende Gruppe team-sendung aus Tag 1:

cp ~/backstage-lab/code/tag03/entwurf.yaml ~/backstage-lab/tag03/entwurf.yaml
cat ~/backstage-lab/tag03/entwurf.yaml
cat >> ~/backstage-lab/portal/app-config.local.yaml <<'EOF'
    # lokale Datei zum Ausprobieren (Tag 3, Drill 3)
    - type: file
      target: ${LAB}/tag03/entwurf.yaml
EOF
~/backstage-lab/setup/portal.sh restart

Erwartet:

apiVersion: backstage.io/v1alpha1
kind: Group
metadata:
  name: team-sendung
  description: Entwurf – zieht an Tag 4 nach kranich/org um
spec:
  type: team
  children: []

Der cat >> hängt einen vierten Listeneintrag an catalog.locations an – das geht, weil locations bisher der letzte Block der Datei ist. Kommt die Gruppe an?

bs catalog/entities/by-name/group/default/team-sendung || echo "nicht da"
~/backstage-lab/setup/portal.sh logs 300 \
  | grep -o 'Entity group:[^ ]*\|is not of an allowed kind for that location'

Erwartet:

nicht da
Entity group:default/team-sendung
is not of an allowed kind for that location

Warum? catalog.rules erlaubt global nur die sechs Kinds aus Tag 2 – Group ist nur für examples/org.yaml per Regel am Eintrag freigeschaltet. Die abgelehnte Entity taucht nirgends in der GUI auf, nur im Log. Freischalten nur für diese Location:

ref=$(~/backstage-lab/setup/portal.sh logs 400 | grep 'allowed kind' \
  | grep -o 'location:default/generated-[0-9a-f]*' | tail -1); echo "$ref"
cat >> ~/backstage-lab/portal/app-config.local.yaml <<'EOF'
      rules:
        - allow: [Group]
EOF
~/backstage-lab/setup/portal.sh restart
bs catalog/refresh -X POST -H 'Content-Type: application/json' \
  -d "{\"entityRef\":\"$ref\"}"
sleep 5
bs catalog/entities/by-name/group/default/team-sendung | jq -r .metadata.name
bs catalog/entities/by-name/component/default/sendungs-api | jq -c .relations

Erwartet (der Hash hängt vom Dateipfad ab und weicht ab):

location:default/generated-df36173cc9451c4a4b72bd4335d84580ef5f747f
team-sendung
[{"type":"ownedBy","targetRef":"group:default/team-sendung"},{"type":"providesApi"…

Die Location-ID holst du vor dem Neustart, denn portal.sh beginnt mit jedem Start ein frisches Log. Ohne den refresh erscheint die Gruppe erst beim nächsten regulären Durchlauf (alle 100–150 s). Die Relations-Warnung an sendungs-api ist jetzt weg.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Auto-Discovery mit dem Gitea-Provider

Statt jedes Repo einzeln zu registrieren, fragt ein Entity-Provider Forgejo regelmäßig nach allen Repos der Org und legt für jedes mit catalog-info.yaml eine Location an. Das Modul bringt create-app nicht mit:

cd ~/backstage-lab/portal
yarn --cwd packages/backend add @backstage/plugin-catalog-backend-module-gitea
grep module-gitea packages/backend/package.json

Erwartet (gekürzt):

➤ YN0000: · Yarn 4.13.0
...
➤ YN0000: · Done with warnings in 10s 243ms
    "@backstage/plugin-catalog-backend-module-gitea": "^0.1.16",

Im Backend registrieren, direkt nach dem Logs-Modul des Katalogs:

sed -i '' "/plugin-catalog-backend-module-logs/a\\
backend.add(import('@backstage/plugin-catalog-backend-module-gitea'));
" packages/backend/src/index.ts
git diff packages/backend/src/index.ts | grep '^+b'

Erwartet:

+backend.add(import('@backstage/plugin-catalog-backend-module-gitea'));

Die Konfigurationsschlüssel stehen im Modul selbst (dist/providers/config.cjs.js): host (muss zu integrations.gitea passen), organization, optional branch und catalogPath (Standard main bzw. catalog-info.yaml) sowie ein Pflicht-schedule. providers hängt als neuer Unterblock an catalog:

cat >> app-config.local.yaml <<'EOF'
  providers:
    gitea:
      kranich:
        host: 127.0.0.1:3300
        organization: kranich
        branch: main
        catalogPath: catalog-info.yaml
        schedule:
          frequency: { minutes: 1 }
          timeout: { minutes: 1 }
EOF
~/backstage-lab/setup/portal.sh restart
~/backstage-lab/setup/portal.sh logs 300 | sed 's/\x1b\[[0-9;]*m//g' \
  | grep -E 'gitea-provider' | cut -c26-110

Erwartet (gekürzt):

catalog info Registered scheduled task: gitea-provider:kranich:refresh, {"version":…
catalog warn Repo http://127.0.0.1:3300/kranich/katalog does not contain a catalog…
catalog warn Source gitea-provider:kranich detected conflicting entityRef location:…
catalog warn Source gitea-provider:kranich detected conflicting entityRef location:…
catalog warn Source gitea-provider:kranich detected conflicting entityRef location:…
catalog info Found 3 locations from 4 repos target="gitea-provider:kranich" class=…

Vier Repos, drei mit catalog-info.yaml – kranich/katalog wird übersprungen, sonst würde es seine Resources doppelt liefern. Die drei Konflikte sind gewollt lehrreich: Der Provider erzeugt für jedes Repo dieselbe Location (generated-…) wie deine Registrierung aus Tag 1/2. Wer zuerst da war, gewinnt; der Provider wird abgewiesen.

Tipp: Der Provider liest catalog-info.yaml über die Forgejo-API mit dem Bot-Token. Repos, die backstage-bot nicht sehen darf, findet er nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Unregister oder Delete?

Zuerst Delete: Eine Entity zu löschen entfernt nur den gespeicherten Stand – ihre Location liefert sie beim nächsten Durchlauf wieder.

uid=$(bs catalog/entities/by-name/component/default/sendungs-worker \
  | jq -r .metadata.uid); echo "$uid"
bs catalog/entities/by-uid/$uid -X DELETE -w '%{http_code}\n'
bs catalog/entities/by-name/component/default/sendungs-worker || echo "weg"
until bs catalog/entities/by-name/component/default/sendungs-worker >/dev/null
do sleep 5; done
bs catalog/entities/by-name/component/default/sendungs-worker | jq -r .metadata.uid

Erwartet (UIDs weichen ab, das Warten dauert bis zu ca. 2 min):

fd0f37b3-8ef8-431f-9ed9-f5d7fb7ce7de
204
weg
fed6dc38-bec1-4d2d-a772-f2b34137fc8b

Neue UID, gleiche Entity. Dauerhaft weg ist etwas erst, wenn die Location verschwindet. Im Browser:

  1. http://localhost:3000/catalog/default/component/tracking-web öffnen.
  2. ⋮ → Unregister entity.
  3. Advanced Options aufklappen.

Erwartet: Der Dialog nennt alle Entities der Location und bietet zwei Wege.

Unregister-Dialog mit aufgeklappten Advanced Options
  1. Unregister Location klicken.

Delete Entity wäre der Weg aus dem ersten Versuch oben – nur sinnvoll, wenn die Datei an der Quelle schon gelöscht ist. Die beiden übrigen Locations aus Tag 1/2 entfernst du per API:

for id in $(bs catalog/locations | jq -r '.[].data.id'); do
  bs catalog/locations/$id -X DELETE -w '%{http_code}\n'
done
bs catalog/locations | jq length
until bs catalog/entities/by-name/component/default/tracking-web >/dev/null; do
  sleep 5; done; echo "tracking-web ist zurück"

Erwartet (das Warten dauert bis zu einer Minute):

204
204
0
tracking-web ist zurück

Warum? Nach dem Unregister ist der Weg für den Gitea-Provider frei: Sein nächster Lauf legt dieselben Locations an, diesmal ohne Konflikt. Ab jetzt gehört kein Repo mehr einer Hand-Registrierung.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Processing-Fehler finden

Ein typischer Fehler: Jemand benennt die OpenAPI-Datei um, $text zeigt ins Leere.

cd ~/backstage-lab/tag03
git clone -q http://lab-admin:[email protected]:3300/kranich/sendungs-api.git
cd sendungs-api
sed -i '' 's#\$text: ./openapi.yaml#$text: ./openapi-v2.yaml#' catalog-info.yaml
git -c user.name="Lab Admin" -c [email protected] \
  commit -qam "API-Definition umbenannt" && git push -q
bs catalog/refresh -X POST -H 'Content-Type: application/json' \
  -d '{"entityRef":"api:default/sendungs-api"}'
sleep 5
bs 'catalog/entities?fields=kind,metadata.name,status' | jq -r '.[]
  | select(.status.items) | "\(.kind):\(.metadata.name)  \(.status.items[0].message)"' \
  | cut -c1-85

Erwartet:

API:sendungs-api  InputError: Processor PlaceholderProcessor threw an error while pre

Der Fehler steht in status.items der Entity. Im Browser http://localhost:3000/catalog/default/api/sendungs-api öffnen.

Erwartet: ein roter Fehlerkasten über der Seite; der Pfeil rechts klappt den Stacktrace auf.

Processing-Fehler auf der Entity-Seite

Darunter siehst du noch die alte OpenAPI-Definition: Schlägt die Verarbeitung fehl, behält der Katalog den letzten guten Stand. Ein Fehler fällt deshalb oft erst Tage später auf. Reparieren:

git -c user.name="Lab Admin" -c [email protected] revert --no-edit HEAD \
  >/dev/null && git push -q
bs catalog/refresh -X POST -H 'Content-Type: application/json' \
  -d '{"entityRef":"api:default/sendungs-api"}'
sleep 5
bs catalog/entities/by-name/api/default/sendungs-api | jq -c '.status // "ok"'

Erwartet:

"ok"

Fortschritt speichern? Kostenlos registrieren

Drill 7: Orphans und Refresh-Intervall

In Backstage 1.55 ist catalog.orphanStrategy: delete der Standard (früher keep): Verwaiste Entities räumt ein Job alle 30 s ab. Um einen Orphan zu sehen, schaltest du das kurz ab und verkürzt mit catalog.processingInterval die Verarbeitungsschleife (Standard: zufällig 100–150 s):

cd ~/backstage-lab/portal
cat >> app-config.local.yaml <<'EOF'
  processingInterval: { seconds: 20 }
  orphanStrategy: keep
EOF
echo '# Gruppen kommen ab Tag 4 aus kranich/org' > ~/backstage-lab/tag03/entwurf.yaml
~/backstage-lab/setup/portal.sh restart
until bs 'catalog/entities?filter=metadata.annotations.backstage.io/orphan=true' \
  | jq -e 'length > 0' >/dev/null; do sleep 5; done
bs 'catalog/entities?filter=metadata.annotations.backstage.io/orphan=true' \
  | jq -r '.[] | "\(.kind):\(.metadata.name)"'

Erwartet (nach etwa 30 s):

Group:team-sendung

Die Location für entwurf.yaml existiert noch, liefert die Gruppe aber nicht mehr. Der Katalog markiert sie mit backstage.io/orphan: "true". Im Browser http://localhost:3000/catalog/default/group/team-sendung öffnen.

Erwartet: ein Warnhinweis mit Delete entity rechts.

Orphan-Warnung auf der Gruppenseite

Statt zu klicken, stellst du die Standard-Strategie wieder her und lässt den Katalog aufräumen:

sed -i '' '/orphanStrategy: keep/d' app-config.local.yaml
~/backstage-lab/setup/portal.sh restart
until ! bs catalog/entities/by-name/group/default/team-sendung >/dev/null; do
  sleep 5; done
~/backstage-lab/setup/portal.sh logs 300 | sed 's/\x1b\[[0-9;]*m//g' \
  | grep -E 'Registered.*orphan|orphaned entities' | cut -c26-108

Erwartet:

catalog info Registered scheduled task: catalog_orphan_cleanup, {"version":2,"caden…
catalog info Deleted 1 orphaned entities

Per Klick geht es auch: Delete entity im Warnhinweis, dann im Dialog Delete. processingInterval: { seconds: 20 } bleibt fürs Lab drin – Änderungen in Forgejo kommen so schneller an.

Achtung: Entfernst du einen Provider aus der Konfiguration, löscht der Katalog beim nächsten Start alle seine Entities (catalog.orphanProviderStrategy, Standard ebenfalls delete). Erst umbauen, dann den alten Provider entfernen.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

Die Datei liegt auch unter ~/backstage-lab/code/tag03/kontrollpunkt.sh.

source ~/backstage-lab/setup/env.sh
ok() { echo "✔ $1"; }; nok() { echo "✘ $1"; }
grep -q catalog-backend-module-gitea "$PORTAL/packages/backend/src/index.ts" \
  && ok "Gitea-Provider im Backend" || nok "backend.add(...gitea) fehlt"
n=$(bs catalog/locations | jq length)
[ "$n" = 0 ] && ok "keine per API registrierten Locations mehr" \
  || nok "$n Location(s) noch per API registriert"
for c in sendungs-api tracking-web sendungs-worker; do
  bs "catalog/entities/by-name/component/default/$c" >/dev/null \
    && ok "Component $c im Katalog" || nok "Component $c fehlt"
done
bs catalog/entities/by-name/location/default/kranich-extern >/dev/null \
  && ok "Sammel-Location kranich-extern" || nok "Location kranich-extern fehlt"
bs catalog/entities/by-name/resource/default/paketdienst >/dev/null \
  && ok "Resource paketdienst aus kranich/katalog" || nok "paketdienst fehlt"
e=$(bs 'catalog/entities?fields=kind,metadata.name,status' \
  | jq '[.[] | select(.status.items)] | length')
[ "$e" = 0 ] && ok "keine Processing-Fehler" || nok "$e Entity(s) mit Fehlern"
o=$(bs 'catalog/entities?filter=metadata.annotations.backstage.io/orphan=true' \
  | jq length)
[ "$o" = 0 ] && ok "keine Orphans" || nok "$o Orphan(s)"

Erwartet:

✔ Gitea-Provider im Backend
✔ keine per API registrierten Locations mehr
✔ Component sendungs-api im Katalog
✔ Component tracking-web im Katalog
✔ Component sendungs-worker im Katalog
✔ Sammel-Location kranich-extern
✔ Resource paketdienst aus kranich/katalog
✔ keine Processing-Fehler
✔ keine Orphans

Die vollständige app-config.local.yaml nach diesem Tag liegt unter ~/backstage-lab/code/tag03/app-config.local.yaml.

Challenge

Lege das Repo kranich/zustell-app mit einer catalog-info.yaml an (Component zustell-app, System sendungsverfolgung) und beweise per API, dass es im Katalog erscheint, ohne dass du es registrierst.

Hinweis: Die Dateien liegen fertig in ~/backstage-lab/code/tag03/zustell-app, und der Provider läuft einmal pro Minute.

Lösung

source ~/backstage-lab/setup/env.sh
~/backstage-lab/setup/mkrepo.sh kranich/zustell-app \
  ~/backstage-lab/code/tag03/zustell-app
s=$SECONDS; until bs catalog/entities/by-name/component/default/zustell-app \
  >/dev/null; do sleep 5; done; echo "nach $((SECONDS - s)) s im Katalog"
bs catalog/entities/by-name/component/default/zustell-app \
  | jq -c '{name: .metadata.name, system: .spec.system}'
bs catalog/locations | jq length
~/backstage-lab/setup/portal.sh logs 400 | sed 's/\x1b\[[0-9;]*m//g' \
  | grep 'gitea-provider:kranich"' | tail -1 | cut -c26-101

Erwartet (die Wartezeit liegt zwischen wenigen Sekunden und gut einer Minute):

✔ kranich/zustell-app angelegt (http://127.0.0.1:3300/kranich/zustell-app)
nach 35 s im Katalog
{"name":"zustell-app","system":"sendungsverfolgung"}
0
catalog info Found 4 locations from 5 repos target="gitea-provider:kranich"

bs catalog/locations bleibt bei 0: Die neue Location stammt vom Provider. Im Katalog findest du die App über das Suchfeld.

Die per Discovery gefundene zustell-app im Katalog

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Discovery statt Hand-Registrierung: Bei GitHub/GitLab heißen die Module catalog-backend-module-github bzw. -gitlab und können zusätzlich nach Topics, Branches oder Gruppen filtern; der Gitea-Provider kennt nur organization.
  • Polling skaliert schlecht: Bei Hunderten Repos Webhooks/Events nutzen (GitHub- und GitLab-Provider unterstützen das) und den schedule großzügig wählen, sonst greifen API-Rate-Limits.
  • catalog.rules restriktiv halten (z. B. Template, User, Group nur aus zentralen Repos) – sonst kann jedes Team per catalog-info.yaml Templates oder Gruppen einschmuggeln.
  • Processing-Fehler aktiv überwachen (Tag 14: catalog-backend-module-logs, Metriken), denn der Katalog zeigt still den letzten guten Stand.
  • orphanStrategy und orphanProviderStrategy bewusst entscheiden und vor Provider-Umbauten ein Datenbank-Backup ziehen (Tag 13).