From f264581a2b5d4d74a7992bc22e080c3f2d312e90 Mon Sep 17 00:00:00 2001 From: Kai Moritz Date: Sun, 31 May 2026 11:04:26 +0000 Subject: [PATCH] =?utf8?q?CLAUDE.md:=20bootstrap-gradle.sh=20=E2=86=92=20i?= =?utf8?q?nit-exercises.sh,=20Beschreibungen=20aktualisiert?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit - Skript-Tabelle: bootstrap-gradle.sh durch init-exercises.sh ersetzt, README-gradle.sh-Beschreibung auf neue --update-Logik aktualisiert - Reine Docker-Verzeichnisse: Beschreibung präzisiert (Image-Artefakte in unterschiedlichen Setups zum Analysieren des Verhaltens) - gradle-wrapper.properties als maßgebliche Gradle-Versionsquelle dokumentiert - Versions-Marker .gradle-version als gitignoriert erwähnt - TGZ-Verzeichnisstruktur: Referenz auf bootstrap-gradle.sh aktualisiert Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index dcb1067e..d30fd36d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -171,7 +171,7 @@ Ein typischer Übungs-Branch enthält: - `pom.xml` und/oder `build.gradle` — Maven/Gradle-Build - `src/` — Java-Quellcode (Gruppe `de.juplo.kafka`) -Einige Branches enthalten **nur** eine `docker/docker-compose.yml` ohne Build-Dateien oder Quellcode. Dies sind reine Infrastruktur-Setups für Übungen, in denen Teilnehmer mit Kafka-Clients aus einer vorherigen Übung weiterexperimentieren. +Einige Branches enthalten **nur** eine `docker/docker-compose.yml` ohne Build-Dateien oder Quellcode. Dies sind reine Infrastruktur-Setups für Übungen, in denen die zuvor als Image gebauten Artefakte in unterschiedlichen Setups verwendet werden, um das Verhalten der Technik zu analysieren. Übung ausführen: ```bash @@ -211,18 +211,18 @@ Nach Massenoperationen immer zu `scripting` zurückkehren — Skripte führen am ### Skripte im `springkafka/technik-check--vorlage`-Branch -Dieser Branch enthält zwei zusätzliche Skripte für das Gradle-Setup: +Dieser Branch enthält zwei zusätzliche Skripte für die Schulungs-Initialisierung: | Skript | Zweck | |--------|-------| -| `bootstrap-gradle.sh` | Erzeugt den fehlenden `gradle-wrapper.jar` (per lokaler Gradle-Installation oder Download von GitHub). Mit `--distribute`: kopiert JAR und `gradlew` in alle Geschwister-Übungsverzeichnisse | -| `README-gradle.sh` | Wie `README.sh`, aber für den Gradle-Build: ruft zuerst `bootstrap-gradle.sh` auf, baut dann mit `./gradlew bootBuildImage` | +| `init-exercises.sh` | Initialisiert die mit `copy.sh` kopierten Übungsverzeichnisse (`vorlagen/`, `livecoding/`, `spickzettel/`). Standard: `--maven` (entfernt Gradle-Artefakte). Mit `--gradle`: verteilt Gradle-Wrapper (JAR, properties, gradlew) und entfernt Maven-Artefakte. Beide Modi löschen Build-Ausgaben und Caches. Scheitert mit Fehler, wenn `--gradle` verwendet wird, aber der Wrapper noch nicht bereit ist — dann zuerst `README-gradle.sh` ausführen. | +| `README-gradle.sh` | Technik-Check für Gradle: stellt Gradle-Wrapper bereit (lädt ihn herunter, falls fehlend) und führt Build-Test durch. Ohne Schalter: scheitert laut, wenn installierte Version nicht zur benötigten passt. Mit `--update`: ersetzt veralteten Wrapper durch die benötigte Version. | -`gradle-wrapper.jar` ist absichtlich nicht im Repository (wird von Unternehmens-Mail-Filtern blockiert). `gradlew` und `gradle/wrapper/gradle-wrapper.properties` sind versioniert. +`gradle-wrapper.jar` ist absichtlich nicht im Repository (wird von Unternehmens-Mail-Filtern blockiert). `gradlew` und `gradle/wrapper/gradle-wrapper.properties` sind versioniert und definieren die maßgebliche Gradle-Version für alle Übungen der Schulung. Der Versions-Marker `gradle/wrapper/.gradle-version` ist gitignoriert. ### TGZ-Verzeichnisstruktur -Branch-Namen bilden auch die Verzeichnisstruktur im verteilten TGZ ab: Der Branch `springkafka/technik-check--vorlage` wird als `springkafka/technik-check/` extrahiert. Von dort ist `../..` das Trainings-Wurzelverzeichnis — so funktioniert `bootstrap-gradle.sh --distribute` korrekt. +Branch-Namen bilden auch die Verzeichnisstruktur im verteilten TGZ ab: Der Branch `springkafka/technik-check--vorlage` wird als `springkafka/technik-check/` extrahiert. Von dort ist `../..` das Trainings-Wurzelverzeichnis — so findet `init-exercises.sh` alle Übungsverzeichnisse korrekt. ## Einen neuen Übungs-Branch hinzufügen -- 2.39.5