Merge branch 'release/v6.1.0'

Author: meiserloh

.gitignore

@@ -19,6 +19,14 @@ authorized_keys
 .env.sh
 terraform.tfvars
 
+/k3d/config.env
+/k3d/.bin
+/k3d/environments/*.env
+/k3d/environments/*.yaml
+!/k3d/environments/.gitkeep
+/.kube/
+/k3d/.kube/
+
 # generated values file for longhorn
 .longhorn-values.yaml
 # generated values file for ecosystem-core
@@ -36,4 +44,4 @@ terraform.tfvars
 /terraform/examples/ces_google_gke/ces_cluster/kubeconfig
 /terraform/examples/ces_google_gke/secretVars.tfvars
 
-/terraform/plusserver/gardener_kubeconfig.yaml
+/terraform/plusserver/gardener_kubeconfig.yaml

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [v6.1.0] - 2026-09-08
+### Added
+- a local `k3d` development workflow for creating and managing CES test environments with local k3d-clusters.
+- [#147] add german docs translations
+- [#151] add bash script guideline
+
 ## [v6.0.1] - 2026-06-02
 ### Changed
 - [#142] activate Cilium NetworkPolicy in terraform module

Vagrantfile

@@ -206,6 +206,7 @@ Vagrant.configure("2") do |config|
                             helm_registry_username,
                             helm_registry_password,
                             helm_registry_host,
+                            helm_registry_host,
                             helm_registry_schema,
                             helm_registry_plain_http,
                             kube_ctx_name,

docs/development/.lop-idp-ecosystem-core-values-patch.yaml

@@ -1,10 +1,14 @@
+# example to setup with lop-idp and dogu V3 features
+skipPreconditionValidation: false
 components:
+  k8s-service-discovery:
+    valuesObject:
+      exposition:
+        exposePorts: true
+        discoverServices: true
+        discoverExpositionCR: true
   lop-idp:
-    version: 1.1.0
     valuesObject:
-      defaultConfig:
-        env:
-          initialDomain: "k3ces.localdomain"
       ldap:
         secrets:
           initialAdminPasswordSecretRef:
@@ -15,13 +19,8 @@ components:
         configuration:
           normal:
             allow_local_urls: "true"
-  k8s-dogu-operator:
-    valuesObject:
-      controllerManager:
-        env:
-          authRegistrationEnabled: true
-          disablePostfixDependencyCheck: true
-  k8s-auth-registration-crd:
-    version: 1.0.0
-  postfix:
-    version: 3.10.8-3
+use-lop-idp: true
+defaultConfig:
+  env:
+    initialDomain: "k3ces.localdomain"
+    initialFQDN: "k3ces.localdomain"

docs/development/bash_script_guideline_de.md

@@ -0,0 +1,67 @@
+Im Folgenden finden Sie einige Best Practices für Bash-Skripte.
+
+## Beginnen Sie mit einem Shebang
+
+Die erste Zeile in einem Bash-Skript sollte lauten:
+
+```bash
+#!/bin/bash
+```
+
+## Fügen Sie eine Beschreibung hinzu
+
+Fügen Sie am Anfang des Skripts eine Beschreibung ein, wenn dessen Zweck nicht bereits durch den Namen oder Ähnliches eindeutig ersichtlich ist.
+
+## Fehlerbehandlung
+
+Verwenden sie die folgenden „set“-Zeilen, damit das Skript bei Fehlern beendet wird, anstatt diese zu ignorieren:
+````bash
+set -o errexit
+````
+Weist Bash an, das Skript sofort zu beenden, wenn ein Befehl einen Exit-Status ungleich Null hat. Sie können „|| true“ zu Befehlen hinzufügen, bei denen ein Fehlschlag bzw. ein Exit-Code ungleich Null zulässig ist.
+````bash
+set -o nounset
+````
+Wenn diese Option gesetzt ist, führt der Verweis auf eine Variable, die Sie zuvor nicht definiert haben – mit Ausnahme von $* und $@ –, zu einem Fehler und bewirkt, dass das Programm sofort beendet wird.
+````bash
+set -o pipefail
+````
+Diese Einstellung verhindert, dass Fehler in einer Pipeline verdeckt werden. Wenn ein Befehl in einer Pipeline fehlschlägt, wird dessen Rückgabecode als Rückgabecode der gesamten Pipeline verwendet.
+
+
+## Fehlerinformationen an stderr ausgeben
+
+Geben Sie alle Fehlerdaten an stderr aus, indem Sie
+````bash
+echo "this is an error" >&2
+````
+
+vor oder hinter „echo“-Befehle setzen.
+
+## Variablen mit ${} verwenden
+
+Verwenden Sie beim Verweisen auf Variablen geschweifte Klammern anstelle von nur $VARIABLE. Dieser Standard verhindert Probleme bei der Verwendung der Bash-Variablen.
+
+## apt-get automatisieren
+
+Die folgenden Zeilen sind nützlich, wenn Software automatisch mit apt-get installiert wird:
+````bash
+apt-get --assume-yes (oder -y) ...
+````
+
+Automatische Antwort „yes“ auf Fragen von apt-get
+````bash
+DEBIAN_FRONTEND=noninteractive apt-get ...
+````
+
+Sorgt dafür, dass das Frontend überhaupt nicht mit Ihnen interagiert und bei allen Fragen die Standardantworten verwendet werden.
+
+## Temporäre Daten entfernen
+
+Nachdem Sie Installationsdaten an einen temporären Speicherort kopiert und ausgeführt haben, vergessen Sie nicht, diese zu entfernen, wenn Ihre Installation erfolgreich war.
+
+## Weitere Informationen
+
+[Inoffizielle Beschreibung des Bash-Strict-Modus](http://redsymbol.net/articles/unofficial-bash-strict-mode/)
+
+[Bewährte Vorgehensweisen beim Schreiben von Bash-Skripten](http://kvz.io/blog/2013/11/21/bash-best-practices/)

docs/development/bash_script_guideline_en.md

@@ -0,0 +1,69 @@
+In the following you find some bash script best practices.
+
+## Start with a shebang
+
+The first line in a bash script should be
+
+```bash
+#!/bin/bash
+```
+
+## Add description
+
+Put a description in the beginning of the script if its purpose is not totally clear by its name or the like.
+
+## Error handling
+
+Use the following set lines to make your script exit on errors instead of ignoring them:
+
+```bash
+set -o errexit
+```
+Instructs bash to immediately exit if any command has a non-zero exit status. You may add '|| true' to commands that you allow to fail/have a non-zero exit code.
+
+```bash
+set -o nounset
+```
+When set, a reference to any variable you haven't previously defined - with the exceptions of $* and $@ - is an error, and causes the program to immediately exit.
+
+```bash
+set -o pipefail
+```
+This setting prevents errors in a pipeline from being masked. If any command in a pipeline fails, that return code will be used as the return code of the whole pipeline.
+
+## Write error information to stderr
+
+Write all error data to stderr by putting
+
+```bash
+echo "this is an error" >&2
+```
+in front of or after 'echo' commands.
+
+## Use variables with ${}
+
+When referencing variables, use curly brackets instead of just $VARIABLE. This standard prevents problems when using bash variables.
+
+## Automate apt-get
+
+The following lines are useful if software is automatically installed using apt-get:
+
+```bash
+apt-get --assume-yes (or -y) ...
+```
+Automatic 'yes' answer to questions from apt-get
+
+```bash
+DEBIAN_FRONTEND=noninteractive apt-get ...
+```
+Makes the frontend never interact with you at all and makes the default answers be used for all questions.
+
+## Remove temporary data
+
+After copying installation data to a temporary location and executing it, do not forget to remove it if your installation was successful.
+
+## Further information
+
+[Unofficial Bash Strict Mode Description](http://redsymbol.net/articles/unofficial-bash-strict-mode/)
+
+[Best Practices for writing Bash scripts](http://kvz.io/blog/2013/11/21/bash-best-practices/)

docs/development/dev_box_de.md

@@ -4,6 +4,9 @@ Dieses Dokument enthält die notwendigen Informationen, um die Entwicklungs-Base
 Eine Anleitung für die Erstellung des Images für die Entwicklungs-Basebox ist [hier](./building_basebox_de.md) zu
 finden.
 
+Für einen leichtgewichtigen lokalen Entwicklungsweg ohne VM gibt es außerdem eine `k3d`-Variante:
+[Dev-Box mit k3d](./dev_box_k3d_de.md).
+
 ### Vorbedingungen
 
 #### Applikationen
@@ -162,4 +165,4 @@ Hinweise:
 #### Cas Konfiguration
 Damit das cas Dogu die Logout-Urls lokal korrekt weiterleitet, ist es wichtig, 
 dass in der Konfiguration für cas der Key `allow_local_urls` auf `"true"` gesetzt wird.
-Dadurch ist für den cas `*.localdomain` eine valide Domain und die Logout-Urls werden korrekt gesetzt.
+Dadurch ist für den cas `*.localdomain` eine valide Domain und die Logout-Urls werden korrekt gesetzt.

docs/development/dev_box_en.md

@@ -3,6 +3,9 @@
 This document contains the necessary information to start the development basebox locally with Vagrant.
 Instructions for building the image for the development basebox can be found [here](./building_basebox_en.md).
 
+For a lightweight local development path without a VM, there is also a `k3d`-based variant:
+[Dev Box with k3d](./dev_box_k3d_en.md).
+
 ### Preconditions
 
 #### Applications