Aufteilung readme Themen

Author: wlanboy

db-schwenk.md

@@ -0,0 +1,60 @@
+# MySQL aktivieren (Feature Flag)
+
+Die App startet standardmäßig mit einer In-Memory-H2-Datenbank. Der Wechsel auf eine externe MySQL-Instanz erfolgt über das Feature Flag `mysql.external.enabled` in `values.yaml`.
+
+## 1. Lokale MySQL-Instanz starten
+
+```bash
+cd mysql
+docker-compose up -d
+```
+
+Startet MySQL auf Port 3306 mit Datenbank `restdata` und User `restdata` (Passwort: `restdata`).
+
+## 2. DNS für Istio ServiceEntry prüfen
+
+Istio registriert den Hostnamen `mysql.extern.big.lan` als `ServiceEntry` im Mesh. CoreDNS muss diesen Namen auflösen können — sonst kann der Envoy-Sidecar keine Verbindung aufbauen.
+
+DNS-Auflösung aus dem `helloworld`-Namespace prüfen:
+
+```bash
+kubectl run dnstest -it --rm --image=busybox --restart=Never -n default -- nslookup mysql.extern.big.lan
+kubectl run dnstest -it --rm --image=busybox --restart=Never -n helloworld -- nslookup mysql.extern.big.lan
+```
+
+Erwartet: eine IP-Antwort. Schlägt die Auflösung fehl, `resolution: STATIC` mit der Docker-Bridge-IP verwenden (siehe Schritt 3).
+
+## 3. values.yaml anpassen
+
+```yaml
+mysql:
+  external:
+    enabled: true
+    host: mysql.extern.big.lan
+    port: 3306
+    resolution: STATIC      # STATIC wenn kein DNS – IP direkt angeben
+    address: "172.19.0.1"   # Docker-Bridge-IP (Äquivalent zu host.docker.internal)
+    database: restdata
+    username: "restdata"
+    password: "restdata"
+```
+
+Bei `resolution: DNS` entfällt `address` – Istio löst den Hostnamen über CoreDNS auf.
+
+## 4. Helm-Update deployen
+
+```bash
+helm upgrade --install helloworld helmchart/ --namespace helloworld
+```
+
+## 5. Verbindung prüfen
+
+```bash
+curl https://helloworld.tp.lan/db
+```
+
+Erwartet:
+
+```json
+{"connected":true,"type":"MySQL","version":"8.x.x","url":"jdbc:mysql://mysql.extern.big.lan:3306/restdata"}
+```

kunden-traffic.md

@@ -0,0 +1,67 @@
+# Zwei Versionen: intern/extern (Source-Namespace-Routing)
+
+Der Chart deployt **zwei Versionen** derselben App parallel (`values.yaml` → `versions`), um Istio
+Source-Namespace-Routing zu demonstrieren (Details siehe [`request-routing/istio-routing.md`](request-routing/istio-routing.md)):
+
+| Version | `sourceNamespace` | ConfigMap | `info.app.version-label` |
+|---|---|---|---|
+| `extern` | `testclientextern` | `helloworld-config-extern` | `extern` |
+| `intern` | `testclientintern` | `helloworld-config-intern` | `intern` |
+
+Jede Version bekommt ein eigenes Deployment, eine eigene ConfigMap (`config/application-<name>.properties`)
+und ein eigenes DestinationRule-Subset. Der VirtualService routet Sidecar-zu-Sidecar-Traffic
+(Gateway `mesh`) anhand des **Namespace, aus dem der Call kommt**: Ruft ein Pod aus `testclientextern`
+auf, landet er beim `extern`-Subset; aus `testclientintern` beim `intern`-Subset. Traffic über den
+externen Istio-Ingress (`https://helloworld.tp.lan`) hat kein Source-Workload in einem dieser
+Namespaces und landet immer auf der Default-Route (`extern`).
+
+> Das Source-Namespace-Matching wird vom **Envoy-Sidecar des aufrufenden Pods** ausgewertet — die
+> Testclient-Namespaces brauchen deshalb selbst Istio Sidecar-Injection, sonst greift die Regel nicht.
+
+## Testclient-Namespaces anlegen
+
+```bash
+kubectl create namespace testclientextern
+kubectl create namespace testclientintern
+
+kubectl label namespace testclientextern istio-injection=enabled
+kubectl label namespace testclientintern istio-injection=enabled
+```
+
+## Routing mit einem busybox-Pod testen
+
+`busybox` hat kein `curl`, aber `wget` reicht für den Test. Pro Testclient-Namespace ein Pod, der
+den `/actuator/info`-Endpunkt des Services abruft:
+
+```bash
+# Aufruf aus testclientextern → erwartet version-label "extern"
+kubectl run testclient -n testclientextern --image=busybox --restart=Never --rm -it -- \
+  wget -qO- http://helloworld.helloworld.svc.cluster.local:8080/actuator/info
+
+# Aufruf aus testclientintern → erwartet version-label "intern"
+kubectl run testclient -n testclientintern --image=busybox --restart=Never --rm -it -- \
+  wget -qO- http://helloworld.helloworld.svc.cluster.local:8080/actuator/info
+```
+
+Erwartete Ausgabe (Auszug):
+
+```json
+{"app":{"version-label":"extern"}}
+```
+
+bzw. `"version-label":"intern"` für den zweiten Aufruf. Zum Vergleich: der externe Ingress-Aufruf
+landet immer auf `extern`:
+
+```bash
+curl https://helloworld.tp.lan/actuator/info
+```
+
+> Läuft der Pod ohne Sidecar (z.B. weil das Namespace-Label fehlte, bevor der Pod gestartet wurde),
+> antwortet `wget` trotzdem — aber ohne Source-Namespace-Matching landet der Call dann ebenfalls
+> immer auf der Default-Route (`extern`), unabhängig vom Aufrufer-Namespace.
+
+## Aufräumen
+
+```bash
+kubectl delete namespace testclientextern testclientintern
+```

readme.md

@@ -199,6 +199,14 @@ Im h2-Modus (Standard) liefert `/db`:
 
 ---
 
+## Zwei Versionen: intern/extern (Source-Namespace-Routing)
+
+Der Chart deployt zwei Versionen derselben App parallel und routet Traffic anhand des
+Aufrufer-Namespace per Istio. Beschreibung, Testclient-Setup und busybox-Testbefehle:
+**[kunden-traffic.md](kunden-traffic.md)**
+
+---
+
 ## Helm Chart — Manuelle Befehle
 
 ### Testen (lokal rendern, kein Deployment)
@@ -245,64 +253,9 @@ kubectl delete namespace helloworld
 
 ## MySQL aktivieren (Feature Flag)
 
-Die App startet standardmäßig mit einer In-Memory-H2-Datenbank. Der Wechsel auf eine externe MySQL-Instanz erfolgt über das Feature Flag `mysql.external.enabled` in `values.yaml`.
-
-### 1. Lokale MySQL-Instanz starten
-
-```bash
-cd mysql
-docker-compose up -d
-```
-
-Startet MySQL auf Port 3306 mit Datenbank `restdata` und User `restdata` (Passwort: `restdata`).
-
-### 2. DNS für Istio ServiceEntry prüfen
-
-Istio registriert den Hostnamen `mysql.extern.big.lan` als `ServiceEntry` im Mesh. CoreDNS muss diesen Namen auflösen können — sonst kann der Envoy-Sidecar keine Verbindung aufbauen.
-
-DNS-Auflösung aus dem `helloworld`-Namespace prüfen:
-
-```bash
-kubectl run dnstest -it --rm --image=busybox --restart=Never -n default -- nslookup mysql.extern.big.lan
-kubectl run dnstest -it --rm --image=busybox --restart=Never -n helloworld -- nslookup mysql.extern.big.lan
-```
-
-Erwartet: eine IP-Antwort. Schlägt die Auflösung fehl, `resolution: STATIC` mit der Docker-Bridge-IP verwenden (siehe Schritt 3).
-
-### 3. values.yaml anpassen
-
-```yaml
-mysql:
-  external:
-    enabled: true
-    host: mysql.extern.big.lan
-    port: 3306
-    resolution: STATIC      # STATIC wenn kein DNS – IP direkt angeben
-    address: "172.19.0.1"   # Docker-Bridge-IP (Äquivalent zu host.docker.internal)
-    database: restdata
-    username: "restdata"
-    password: "restdata"
-```
-
-Bei `resolution: DNS` entfällt `address` – Istio löst den Hostnamen über CoreDNS auf.
-
-### 4. Helm-Update deployen
-
-```bash
-helm upgrade --install helloworld helmchart/ --namespace helloworld
-```
-
-### 5. Verbindung prüfen
-
-```bash
-curl https://helloworld.tp.lan/db
-```
-
-Erwartet:
-
-```json
-{"connected":true,"type":"MySQL","version":"8.x.x","url":"jdbc:mysql://mysql.extern.big.lan:3306/restdata"}
-```
+Wechsel von der In-Memory-H2-Datenbank auf eine externe MySQL-Instanz über das Feature Flag
+`mysql.external.enabled`. Schritt-für-Schritt-Anleitung inkl. DNS-Check und Verifikation:
+**[db-schwenk.md](db-schwenk.md)**
 
 ---