Skip to content

#88 Document the Dogu V3 Multinode environment for developers - #89

Open
henry-bobka wants to merge 9 commits into
mainfrom
feature/61540-dogu-v3-multinode-environment
Open

#88 Document the Dogu V3 Multinode environment for developers#89
henry-bobka wants to merge 9 commits into
mainfrom
feature/61540-dogu-v3-multinode-environment

Conversation

@henry-bobka

@henry-bobka henry-bobka commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Document the infrastructure relevant to Dogu V3 developers:

  • Explain the relationship between a Dogu V3 Helm chart and the Multinode platform.
  • Cover native Kubernetes resources and the CES integration APIs.
  • Describe Exposition, authentication, service accounts, and Warp Menu integration.
  • Explain asynchronous reconciliation and infrastructure-related troubleshooting.

Closes #88

@henry-bobka
henry-bobka force-pushed the feature/61540-dogu-v3-multinode-environment branch from e383493 to 227eaf7 Compare July 22, 2026 06:47
Base automatically changed from feature/61402-dogu-v3-docs-structure to main July 24, 2026 13:41

@ppxl ppxl left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your change, it was a delight to read 💙 As the leading document seems to be the german doc, I took liberty and commented in german.

I am still undergoing inspection of @henry-bobka's earlier document to see what we should keep.

Comment on lines +43 to +44
Jede Mandantenumgebung erfordert somit ein dediziertes Kubernetes-Cluster, was eine strikte und sichere Mandantentrennung auf Infrastrukturebene gewährleistet.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ich fand den Versuch der Auflösung Begriffskonflikten (Dogu- vs K8s-Namespace) eigentlich ganz gut. Solche Dinge neigen zur Verwirrung. Wenn hier nicht der geeignete Ort dafür ist, dann sollten wir einen Ort dafür schaffen.

Inhaltlich ist generell ein K8s-Namespace standardmäßig und ohne weitere Maßnahmen ein schlechtes Mittel zur Isolation. Auch wenn fachlich eine Mandantentrennung möglich ist (wenn die Grundsatzproblematik gelöst wurde), so ist diese auf technischem Wege nur deutlich teurer umsetzbar.

Sollten wir daher beides ansprechen und ausschließen, damit der Grund dafür klar wird?

Comment thread docs/v3/concepts/multinode-environment_de.md
Comment thread docs/v3/concepts/multinode-environment_de.md
Comment thread docs/v3/concepts/multinode-environment_de.md Outdated
Comment thread docs/v3/concepts/multinode-environment_de.md Outdated
## Networking

Für das Networking in CES-MN wird ein CNI-kompatibler Netzwerk-Treiber (Container Network Interface) eingesetzt.
Die Plattform wurde erfolgreich mit Calico und Cilium getestet. Zur Absicherung des Datenverkehrs zwischen Pods und Namespaces werden NetworkPolicies eingesetzt.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ich glaube, wir sollten erwähnen, dass der Dogu-Operator automatisch NetworkPolicies erzeugt, sodass sich Entwickler darum weniger Gedanken machen müssen.

Zudem: Sollten wir die CNI verlinken?

Suggested change
Die Plattform wurde erfolgreich mit Calico und Cilium getestet. Zur Absicherung des Datenverkehrs zwischen Pods und Namespaces werden NetworkPolicies eingesetzt.
Die Plattform wurde erfolgreich mit [Calico](https://github.com/projectcalico/calico) und [Cilium](https://github.com/cilium/cilium) getestet. Zur Absicherung des Datenverkehrs zwischen Pods und Namespaces werden NetworkPolicies eingesetzt.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Welche NetworkPolicies angelegt werden müssen und welche erstellt werden, würde ich in einem Guide oder HowTo sehen, anstatt im Konzept für die Infrastruktur

Comment thread docs/v3/concepts/multinode-environment_de.md
Comment thread docs/v3/concepts/multinode-environment_de.md Outdated
Comment on lines +95 to +96
Für Umgebungen ohne direkten Internetzugang (Air Gap) können sowohl die benötigten Helm-Charts als auch Container Images
in eine interne OCI-Registry innerhalb der isolierten Umgebung gespiegelt werden.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sollten wir beschreiben, dass es hierzu ebenfalls einen Deskriptor gibt? Wenn nicht, wo sollte das diskutiert werden?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wird in dem Kapitel über die Artefakte behandelt.

Comment thread docs/v3/concepts/multinode-environment_de.md
Co-authored-by: Philipp Pixel <ppxl@users.noreply.github.com>
Comment thread docs/v3/README.md Outdated
Comment thread docs/v3/concepts/multinode-environment_de.md Outdated
Comment thread docs/v3/concepts/multinode-environment_de.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants