Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang B: Abschlussprüfung

Ziel: Nachweisen, dass du eine neue Fachdomäne allein durch das ganze Portal bringst: Katalog, Organisation, Golden Path, TechDocs, Suche, Startseite und Betrieb. · Dauer: 120 min Praxis + 20 min Fragen · Voraussetzung: Tag 14

Regeln

  • Gelände wie nach Tag 14: check.sh alles ✔, Gitea-Provider (Tag 3), kranich/org (Tag 4), kranich/templates (Tag 5), venv für TechDocs (Tag 7), Startseite (Tag 9), Policy (Tag 12), Postgres im Container bs-postgres (Tag 13).
  • Erlaubt: Anhang A, backstage.io/docs, dein Begleitcode der Tage 0 bis 14. Nicht erlaubt: in code/anhang-b/loesung/ schauen.
  • Arbeitsordner ist ~/backstage-lab/pruefung. Nichts per Register Existing Component oder POST catalog/locations registrieren – Aufgabe 4 prüft das.
  • Templates führst du als thomas.zachmann (Team Plattform, Tag 12) aus oder per bs scaffolder/v2/tasks. Der Gast darf seit Tag 12 keine Templates mehr starten.
  • Das Skript pruefung.sh vergibt die Punkte. Es ändert nichts. Bestanden: mindestens 70 von 100 Punkten und Aufgabe 1 voll. Aufgabe 10 bringt Bonuspunkte, zählt aber nicht zur Summe.
source ~/backstage-lab/setup/env.sh
~/backstage-lab/setup/check.sh | grep ✘ || echo "Gelände ok"
docker start bs-postgres >/dev/null && ~/backstage-lab/setup/portal.sh start
mkdir -p ~/backstage-lab/pruefung && cd ~/backstage-lab/pruefung
bash ~/backstage-lab/code/anhang-b/pruefung.sh | tail -2

Erwartet:

Gelände ok
✔ läuft bereits: http://localhost:3000
Summe: 0 von 100 (Aufgabe 1: 0 von 10, Bonus: 0 von 10)
✘ NICHT BESTANDEN

Szenario

Kranich Logistik holt den Fuhrpark ins Haus. Ein neues Team übernimmt ihn und bekommt eine eigene Domain im Portal:

 Domain fuhrpark ── System flottenmanagement           Owner: team-fuhrpark
                     ├─ Component fahrzeug-api ──provides──► API fahrzeug-api
                     │     └─dependsOn──► Resource fahrzeug-db    (OpenAPI)
                     ├─ Component fahrtenbuch-web ──consumes──┘
                     └─ Component fahrzeug-ortung  (per Template, mit TechDocs)
Name Kind Repo
team-fuhrpark, dana.engel, emil.fischer Group, User kranich/org
fuhrpark, flottenmanagement Domain, System kranich/flottenmanagement
fahrzeug-db, fahrzeug-api, fahrtenbuch-web Resource, API, Component kranich/flottenmanagement
fuhrpark-service Template kranich/templates
fahrzeug-ortung Component kranich/fahrzeug-ortung

Die Namen sind Pflicht, das Skript sucht genau nach ihnen. Beschreibungen, Titel und Texte wählst du selbst. Die Namen lager-* sind seit Tag 5 und 6 vergeben, darum heißt die neue Domain nicht „Lager”.

Aufgaben

Jede Aufgabe nennt das Ziel, nicht den Weg. Der Prüfbefehl darunter zeigt dir, ob du fertig bist. Die Tage in Klammern sagen dir, wo das Werkzeug steht. Die Ausgaben stammen aus einem Testlauf mit der Musterlösung.

Aufgabe Punkte Zeit
1 Team Fuhrpark (Pflicht) 10 10 min
2 Domain, System, Resource 15 15 min
3 Components und API 15 15 min
4 Discovery statt Registrierung 10 5 min
5 Template fuhrpark-service 15 25 min
6 fahrzeug-ortung erzeugen 10 10 min
7 TechDocs mit zwei Seiten 10 10 min
8 Suche 5 5 min
9 Startseite 10 10 min
10 Zusatz: Policy und Backup +10 15 min
Summe 100 120 min

Aufgabe 1: Team Fuhrpark (10 Punkte, Pflicht)

In kranich/org kommt die Group team-fuhrpark (Typ team) unter it dazu, mit den Mitgliedern dana.engel und emil.fischer (Tag 4). org.yaml ist schon als Location eingetragen – kein Neustart nötig.

bs catalog/entities/by-name/group/default/team-fuhrpark | jq -r '.relations[]
  | select(.type == "hasMember" or .type == "childOf") | "\(.type) \(.targetRef)"'

Erwartet:

childOf group:default/it
hasMember user:default/dana.engel
hasMember user:default/emil.fischer

Aufgabe 2: Domain, System, Resource (15 Punkte)

Neues Repo kranich/flottenmanagement mit einer catalog-info.yaml: Domain fuhrpark, darin System flottenmanagement, dazu die Resource fahrzeug-db vom Typ database im System. Owner ist überall team-fuhrpark (Tag 2).

for r in domain/default/fuhrpark system/default/flottenmanagement \
  resource/default/fahrzeug-db; do
  bs catalog/entities/by-name/$r | jq -r '[.kind, .metadata.name,
    (.relations[] | select(.type == "partOf" or .type == "ownedBy")
     | .targetRef)] | join(" ")'
done

Erwartet:

Domain fuhrpark group:default/team-fuhrpark
System flottenmanagement group:default/team-fuhrpark domain:default/fuhrpark
Resource fahrzeug-db group:default/team-fuhrpark system:default/flottenmanagement

Aufgabe 3: Components und API (15 Punkte)

Im selben Repo: Component fahrzeug-api (Typ service) stellt die API fahrzeug-api bereit und hängt von fahrzeug-db ab. Component fahrtenbuch-web (Typ website) nutzt die API. Die API ist vom Typ openapi, ihre Definition liegt als openapi.yaml im Repo und wird per $text eingebunden (Tag 1, Tag 2, Tag 8).

bs catalog/entities/by-name/component/default/fahrzeug-api | jq -r '.relations[]
  | select(.type | test("providesApi|dependsOn")) | "\(.type) \(.targetRef)"'
bs catalog/entities/by-name/api/default/fahrzeug-api \
  | jq -r '.spec.definition' | head -3

Erwartet:

dependsOn resource:default/fahrzeug-db
providesApi api:default/fahrzeug-api
openapi: 3.0.3
info:
  title: Fahrzeug-API

Aufgabe 4: Discovery statt Registrierung (10 Punkte)

Alle Entities aus Aufgabe 2 und 3 kommen über den Gitea-Provider in den Katalog, nicht über eine registrierte Location. Keine davon hat einen Processing-Fehler (Tag 3, Tag 14).

bs catalog/locations | jq '[.[] | select(.data.target
  | test("flottenmanagement"))] | length'
F='relations.ownedBy=group:default/team-fuhrpark'
bs "catalog/entities?filter=$F&fields=kind,metadata.name,status" \
  | jq -r '.[] | "\(.kind) \(.metadata.name) \(.status.items // [] | length)"' \
  | sort

Erwartet:

0
API fahrzeug-api 0
Component fahrtenbuch-web 0
Component fahrzeug-api 0
Domain fuhrpark 0
Resource fahrzeug-db 0
System flottenmanagement 0

Die letzte Zahl ist die Anzahl der Processing-Fehler. Nach Aufgabe 5 und 6 kommen Template fuhrpark-service und Component fahrzeug-ortung dazu.

Aufgabe 5: Template fuhrpark-service (15 Punkte)

Neues Template fuhrpark-service in kranich/templates, abgeleitet von node-service (Tag 5, Tag 6):

  • Feld System als EntityPicker, der nur Systems anbietet.
  • Checkbox mit TechDocs (Standard: an). Ist sie gesetzt, bekommt das Repo mkdocs.yml, zwei Doku-Seiten und die Annotation backstage.io/techdocs-ref.
  • Owner ist immer team-fuhrpark, ohne Auswahlfeld.
  • Repo per publish:gitea, danach catalog:register.
bs catalog/entities/by-name/template/default/fuhrpark-service | jq -c '
  [.spec.parameters[].properties | to_entries[]
   | {(.key): (.value["ui:field"] // .value.type)}] | add'

Erwartet (umbrochen):

{"name":"EntityNamePicker","description":"string","system":"EntityPicker",
"techdocs":"boolean","repoUrl":"RepoUrlPicker"}

Im Wizard unter Create sieht der erste Schritt dann aus wie in der Abbildung. Gibt es nur ein passendes System, wählt der EntityPicker es selbst aus und sperrt das Feld.

Wizard fuhrpark-service: System per EntityPicker, Checkbox mit TechDocs

Aufgabe 6: fahrzeug-ortung erzeugen (10 Punkte)

Erzeuge mit dem Template die Component fahrzeug-ortung im System flottenmanagement, mit TechDocs, Repo kranich/fahrzeug-ortung (Tag 5, Tag 6).

bs catalog/entities/by-name/component/default/fahrzeug-ortung | jq -r '
  .relations[] | select(.type == "partOf" or .type == "ownedBy") | .targetRef'
curl -sf -u "$ADMIN" "$FORGEJO/api/v1/repos/kranich/fahrzeug-ortung/contents" \
  | jq -r '.[].path' | tr '\n' ' '; echo

Erwartet:

group:default/team-fuhrpark
system:default/flottenmanagement
README.md catalog-info.yaml docs mkdocs.yml package.json src

Im Katalog, gefiltert auf Kind Component und Owner Team Fuhrpark, stehen danach drei Components wie in der Abbildung.

Katalog: die drei Components von Team Fuhrpark

Aufgabe 7: TechDocs mit zwei Seiten (10 Punkte)

Die Doku von fahrzeug-ortung ist gebaut und hat mindestens zwei Seiten in der Navigation (Tag 7). Öffne dazu einmal den Tab TechDocs.

D=techdocs/static/docs/default/component/fahrzeug-ortung
bs $D/search/search_index.json \
  | jq -r '.docs[] | select(.location | contains("#") | not) | .title'

Erwartet:

Start
Betrieb

Die Titel kommen aus der Navigation in mkdocs.yml.

Aufgabe 8: Suche (5 Punkte)

Die Suche nach fahrzeug-ortung findet die Component und ihre Doku (Tag 8). Der Kollator läuft jede Minute.

bs 'search/query?term=fahrzeug-ortung' \
  | jq -r '.results[] | "\(.type) \(.document.location)"' | sort -u

Erwartet (die Einträge mit # sind Überschriften innerhalb der Seiten):

software-catalog /catalog/default/component/fahrzeug-ortung
techdocs /docs/default/component/fahrzeug-ortung/
techdocs /docs/default/component/fahrzeug-ortung/#fahrzeug-ortung
techdocs /docs/default/component/fahrzeug-ortung/betrieb/
techdocs /docs/default/component/fahrzeug-ortung/betrieb/#bereitschaft
techdocs /docs/default/component/fahrzeug-ortung/betrieb/#betrieb
techdocs /docs/default/component/fahrzeug-ortung/betrieb/#start

Aufgabe 9: Startseite (10 Punkte)

Das Toolkit auf der Startseite bekommt einen Link Flottenmanagement auf die System-Seite /catalog/default/system/flottenmanagement. Die übrigen Links bleiben (Tag 9).

cd ~/backstage-lab/portal
yarn backstage-cli config:print --frontend --format json 2>/dev/null \
  | jq -r '.app.extensions[] | objects | .["home-page-widget:home/toolkit"]
    // empty | .config.tools[].label'

Erwartet:

Flottenmanagement
Forgejo
Neues Projekt
TechDocs
Backstage-Doku

Aufgabe 10: Zusatz – Policy und Backup (+10 Bonus)

Beide Teile sind optional.

  1. Policy (+5): Entities mit Owner team-fuhrpark darf nur Team Fuhrpark löschen. Team Plattform behält das Löschrecht für alles andere (Tag 12 mit Challenge).
  2. Backup (+5): Sichere die Katalog-Datenbank mit pg_dump im Custom-Format nach ~/backstage-lab/pruefung/catalog.dump, nachdem fahrzeug-ortung im Katalog ist (Tag 13, Challenge). Ohne laufenden Container bs-postgres überspringt das Skript diesen Teil.
docker exec -i bs-postgres pg_restore -f - -a -t final_entities \
  < ~/backstage-lab/pruefung/catalog.dump \
  | grep -o 'component:default/fahrzeug-ortung' | head -1

Erwartet:

component:default/fahrzeug-ortung

Die Policy prüft das Skript nur statisch (Quelltext und index.ts): Ein User-Token eines Fuhrpark-Mitglieds gibt es nur über den Browser-Login (Tag 12). Die Gegenprobe steht in der Musterlösung.

Prüfskript

Das Skript liegt unter ~/backstage-lab/code/anhang-b/pruefung.sh. Es fragt nur ab: Katalog, Scaffolder, TechDocs und Suche per bs, Forgejo per curl, die Startseite per config:print, das Backup per pg_restore. Der Kern:

pt() {  # pt <aufgabe> <punkte> <text> <bash-ausdruck>
  if eval "$4" >/dev/null 2>&1; then
    echo "✔ A$1 $3 (+$2)"; pts[$1]=$((pts[$1] + $2))
  else
    echo "✘ A$1 $3 (0 von $2)"
  fi
}
e() { bs "catalog/entities/by-name/$1"; }                  # e kind/namespace/name
has() { e "$1" | jq -e "$2"; }                             # has <ref> <jq-filter>
rel() { has "$1" "any(.relations[]; .type == \"$2\" and .targetRef == \"$3\")"; }

Jede Prüfung ist eine Zeile. Sie wertet Relationen statt spec-Felder aus – so zählt owner: team-fuhrpark genauso wie owner: group:default/team-fuhrpark:

pt 2 5 "System flottenmanagement in Domain fuhrpark" \
  "rel system/default/flottenmanagement partOf domain:default/fuhrpark &&
   rel system/default/flottenmanagement ownedBy $T"
pt 5 4 "EntityPicker für System" "has $TPL '$EP'"

Aufgabe 4 nutzt, dass catalog/locations nur per API registrierte Locations liefert. Was der Gitea-Provider anlegt, steht dort nicht. Den Container für das Backup wählst du mit PG=…, Standard ist bs-postgres.

bash ~/backstage-lab/code/anhang-b/pruefung.sh

Erwartet bei voller Lösung (gekürzt):

== Teil 1: Katalog
✔ A1 Group team-fuhrpark (team) unter it (+4)
✔ A1 mindestens zwei User in team-fuhrpark (+4)
✔ A1 Team stammt aus kranich/org (+2)
...
✔ A4 Repo kranich/flottenmanagement per Discovery, nicht registriert (+5)
✔ A4 alle Entities von team-fuhrpark ohne Processing-Fehler (+5)
== Teil 2: Golden Path
...
✔ A8 Suche findet die TechDocs (+2)
== Teil 3: Plattform
✔ A9 Toolkit verlinkt das System flottenmanagement (+6)
✔ A9 Toolkit behält dabei den Forgejo-Link (+4)
== Zusatz (optional, Bonus)
✔ A10 Policy: Löschen von Fuhrpark-Entities nur für team-fuhrpark (+5)
✔ A10 Backup pruefung/catalog.dump enthält fahrzeug-ortung (+5)
Summe: 100 von 100 (Aufgabe 1: 10 von 10, Bonus: 10 von 10)
✔ BESTANDEN

Gegen ein Gelände ohne Lösung (gekürzt):

== Teil 1: Katalog
✘ A1 Group team-fuhrpark (team) unter it (0 von 4)
✘ A1 mindestens zwei User in team-fuhrpark (0 von 4)
...
✘ A9 Toolkit behält dabei den Forgejo-Link (0 von 4)
== Zusatz (optional, Bonus)
✘ A10 Policy: Löschen von Fuhrpark-Entities nur für team-fuhrpark (0 von 5)
✘ A10 Backup pruefung/catalog.dump enthält fahrzeug-ortung (0 von 5)
Summe: 0 von 100 (Aufgabe 1: 0 von 10, Bonus: 0 von 10)
✘ NICHT BESTANDEN

Der Exit-Code ist 0 bei Bestehen, sonst 1 – praktisch für eine Pipeline.

Musterlösung

Erst nach der Prüfung lesen. Alle Dateien liegen unter ~/backstage-lab/code/anhang-b/loesung/.

  • A1 (Tag 4, Drill 2): org/team-fuhrpark.yaml an org.yaml in kranich/org anhängen und pushen. Die Group braucht children: [], die User tragen memberOf: [team-fuhrpark].
  • A2–A4 (Tag 2, Drill 2; Tag 3, Drill 4): Ordner flottenmanagement/ mit catalog-info.yaml (sechs Entities) und openapi.yaml per mkrepo.sh als Repo anlegen. Nicht registrieren: Der Provider findet das Repo spätestens nach einer Minute.
cd ~/backstage-lab/pruefung
L=~/backstage-lab/code/anhang-b/loesung
~/backstage-lab/setup/mkrepo.sh kranich/flottenmanagement $L/flottenmanagement

Der entscheidende Teil der catalog-info.yaml:

kind: Component
metadata:
  name: fahrzeug-api
spec:
  type: service
  lifecycle: experimental
  owner: team-fuhrpark
  system: flottenmanagement
  providesApis: [fahrzeug-api]
  dependsOn: [resource:fahrzeug-db]
  • A5 (Tag 6, Drill 3 und Challenge): Ordner fuhrpark-service/ ins geklonte kranich/templates, Zeile - ./fuhrpark-service/template.yaml an templates.yaml, pushen, location:default/kranich-templates refreshen. Gegenüber node-service ändert sich das Formular so:
        system:
          title: System
          type: string
          description: Nur Systems der Domain Fuhrpark
          ui:field: EntityPicker
          ui:options:
            catalogFilter:
              kind: System
              spec.domain: fuhrpark
            defaultKind: System
            allowArbitraryValues: false
        techdocs:
          title: mit TechDocs
          type: boolean
          default: true

Der Owner steht fest in den values des Steps fetch (owner: group:default/team-fuhrpark), der Step techdocs holt mit if: ${{ parameters.techdocs }} den Ordner techdocs/ mit mkdocs.yml (Navigation Start und Betrieb), docs/index.md und docs/betrieb.md. Den Ticket-Step aus Tag 6 braucht das Template nicht.

  • A6 (Tag 6, Drill 7): als thomas.zachmann im Wizard oder per API mit werte.json:
ID=$(bs scaffolder/v2/tasks -X POST -H 'Content-Type: application/json' \
  -d @$L/werte.json | jq -r .id)
bs scaffolder/v2/tasks/$ID | jq -r .status
  • A7 (Tag 7, Drill 5): Tab TechDocs öffnen oder bs techdocs/sync/default/component/fahrzeug-ortung -N.
  • A8 (Tag 8, Drill 5): nichts zu tun außer warten. Der TechDocs-Kollator findet nur Doku, die schon gebaut ist – darum A7 zuerst.
  • A9 (Tag 9, Drill 3): In app-config.yaml unter home-page-widget:home/toolkit → config.tools einen Eintrag ergänzen, dann portal.sh restart. Nicht in app-config.local.yaml: Die Liste würde die ganze Liste ersetzen.
            - url: /catalog/default/system/flottenmanagement
              label: Flottenmanagement
              icon: kind:system
  • A10, Policy (Tag 12, Drill 6 und Challenge): In packages/backend/src/modules/permissionPolicy.ts nach dem Aufruf von getUserInfo eine eigene Behandlung für catalog.entity.delete. Die Imports isResourcePermission, catalogConditions und createCatalogConditionalDecision kennst du aus der Challenge von Tag 12. Vollständige Datei: loesung/permissionPolicy.ts.
const FUHRPARK = 'group:default/team-fuhrpark';
// … in handle(), nach getUserInfo():
if (
  isResourcePermission(request.permission, 'catalog-entity') &&
  request.permission.name === 'catalog.entity.delete'
) {
  const gehoertFuhrpark = catalogConditions.isEntityOwner({
    claims: [FUHRPARK],
  });
  if (ownershipEntityRefs.includes(FUHRPARK)) {
    return createCatalogConditionalDecision(request.permission, gehoertFuhrpark);
  }
  if (ownershipEntityRefs.includes(PLATTFORM)) {
    return createCatalogConditionalDecision(request.permission, {
      not: gehoertFuhrpark,
    });
  }
  return { result: AuthorizeResult.DENY };
}

Die Bedingung prüft der Katalog selbst gegen die Relation ownedBy. Gegenprobe ohne Forgejo-Login: Häng den Gast vorübergehend an Dana (userEntityRef aus Tag 4) und frag das Permission-Backend direkt, mit dem Token des Gasts:

cd ~/backstage-lab/portal && cp app-config.local.yaml app-config.local.yaml.vorher
yq -i '.auth.providers.guest.userEntityRef = "user:default/dana.engel"' \
  app-config.local.yaml
~/backstage-lab/setup/portal.sh restart >/dev/null
tok=$(curl -s "$BACKSTAGE/api/auth/guest/refresh" \
  -H 'X-Requested-With: XMLHttpRequest' | jq -r .backstageIdentity.token)
for e in component:default/fahrzeug-api component:default/sendungs-api; do
  jq -n --arg r "$e" '{items: [{id: "1", resourceRef: $r, permission: {
    type: "resource", name: "catalog.entity.delete",
    attributes: {action: "delete"}, resourceType: "catalog-entity"}}]}' \
  | curl -s -X POST "$BACKSTAGE/api/permission/authorize" \
      -H "Authorization: Bearer $tok" -H 'Content-Type: application/json' -d @- \
  | jq -r --arg r "$e" '"\($r) \(.items[0].result)"'
done

Erwartet:

component:default/fahrzeug-api ALLOW
component:default/sendungs-api DENY

Mit user:default/thomas.zachmann statt Dana ist es umgekehrt (DENY, dann ALLOW). Danach mv app-config.local.yaml.vorher app-config.local.yaml und portal.sh restart. Im GUI zeigt sich dasselbe nach einem Login als Dana über Forgejo (Tag 12, Drill 1) am Menüpunkt Unregister entity (nicht live getestet).

  • A10, Backup (Tag 13, Challenge):
docker exec bs-postgres pg_dump -U backstage -Fc backstage_plugin_catalog \
  > ~/backstage-lab/pruefung/catalog.dump

Alles außer der Policy spielt das Skript loesung/loesung.sh nach (im Testlauf 35 Sekunden, danach portal.sh restart für die Startseite und zwei Minuten für den Suchindex):

bash ~/backstage-lab/code/anhang-b/loesung/loesung.sh
~/backstage-lab/setup/portal.sh restart && sleep 120
bash ~/backstage-lab/code/anhang-b/pruefung.sh | tail -2

Erwartet:

Summe: 100 von 100 (Aufgabe 1: 10 von 10, Bonus: 5 von 10)
✔ BESTANDEN

Mit loesung/permissionPolicy.ts in packages/backend/src/modules/ (danach yarn tsc und portal.sh restart) steht in der vorletzten Zeile Bonus: 10 von 10.

Wissensfragen

Beantworte jede Frage in ein bis zwei Sätzen, ohne Unterlagen. Mindestens 6 von 8 sollten sitzen.

  1. Warum darfst du team-fuhrpark nicht einfach in kranich/flottenmanagement definieren, obwohl der Gitea-Provider das Repo liest?
  2. Das System hängt in der Domain, die Seite der Domain zeigt es aber nicht. Wo suchst du zuerst?
  3. Warum meldet die Discovery für fahrzeug-ortung einen Konflikt, für flottenmanagement aber nicht?
  4. Was liefert der EntityPicker als Wert, und warum funktioniert er trotzdem in spec.system?
  5. Die Checkbox mit TechDocs ist aus. Welche Steps laufen, und was steht im Log?
  6. Die Suche findet fahrzeug-ortung als Component, aber keine Doku. Nenne zwei Gründe.
  7. Warum hat das Toolkit nach einem Eintrag nur unter app.extensions in app-config.local.yaml plötzlich nur noch einen Link?
  8. Warum bleibt eine Policy-Regel für catalog.entity.delete beim Lab-Token lab-cli wirkungslos?

Lösungsschlüssel

  1. Die globalen catalog.rules erlauben User und Group nur an der Location von kranich/org (Tag 4). Sonst könnte jedes Repo Gruppen anlegen und sich Ownership erschleichen.
  2. In der Entity des Systems: spec.domain falsch geschrieben oder die Domain hat einen Processing-Fehler. Die Relation partOf zeigt nur auf eine existierende Entity (Tag 2, Tag 14).
  3. catalog:register hat für fahrzeug-ortung schon eine Location angelegt. Der Provider erzeugt dieselbe Location noch einmal und wird abgewiesen (Tag 3, Tag 5).
  4. Eine volle Referenz wie system:default/flottenmanagement. spec.system nimmt auch Referenzen mit Kind und Namespace an (Tag 6).
  5. Alle außer dem mit if: – das Log meldet Skipping step techdocs because its if condition was false, und catalog-info.yaml hat keine Annotation (Tag 6).
  6. Die Doku wurde noch nie gebaut (Tab nie geöffnet, kein techdocs/sync), oder der TechDocs-Kollator ist seit dem Build noch nicht gelaufen (Tag 8).
  7. Listen in app-config*.yaml werden ersetzt, nicht zusammengeführt. Die Liste aus der local-Datei verdrängt die ganze Liste aus app-config.yaml (Tag 9).
  8. lab-cli ist ein Service-Principal. Für ihn entscheidet das Framework ohne Policy, einschränken lässt er sich nur mit accessRestrictions (Tag 12).