Seminar Dogu-Entwicklung: dogu.json, Konfiguration und Abhängigkeiten

Viele Lifecycle-Fehler entstehen aus unvollständigen Metadaten oder unklaren Konfigurationswirkungen. Der Kurs behandelt die Beschreibung deshalb als prüfbaren Vertrag zwischen Anwendung und Plattform.

Ein bestehendes Beispiel wird schrittweise vervollständigt, validiert und gegen Installations-, Rekonfigurations- sowie Upgradefälle getestet.

Inhaltsübersicht

1. Zielgruppe
2. Lernziele
3. Seminarinhalte
4. Praxisübungen
5. Arbeitsweise

Zielgruppe

Dogu-Entwicklung, Softwarearchitektur, DevOps Engineering und technische Wartung eigener Dogus

Lernziele

• Teilnehmende können dogu.json vollständig und versionssicher modellieren.
• Teilnehmende können Konfigurationsschlüssel mit sicheren Defaults entwerfen.
• Teilnehmende können Abhängigkeiten und Versionsbereiche belastbar beschreiben.
• Teilnehmende können Ports, Volumes und Healthchecks mit Lifecycle-Tests absichern.

Seminarinhalte

1. dogu.json: Metadaten, Versionen und Schnittstellen

Die dogu.json beschreibt Identität, Version, Abhängigkeiten und technische Eigenschaften. Änderungen werden schemaorientiert vorgenommen.

1. Name, Namespace, Version, Anzeigeinformationen und Tags konsistent festlegen.
2. Abhängigkeiten mit zulässigen Versionen und optionalem Charakter beschreiben.
3. Ports, Volumes, Healthcheck, Konfiguration und Dienste vollständig modellieren.
4. Datei syntaktisch und semantisch validieren und gegen den vorgesehenen Lifecycle testen.

2. Konfigurationsschlüssel, Defaults und Geheimnisse

Konfiguration wird nach Gültigkeitsbereich, Sensibilität und Änderungswirkung strukturiert. Sichere Defaults reduzieren Fehlkonfigurationen.

1. Globale, Dogu-spezifische und umgebungsabhängige Einstellungen voneinander trennen.
2. Schlüssel mit Datentyp, Default, Pflichtstatus und Validierungsregel definieren.
3. Geheimnisse kennzeichnen und Ausgabe in Logs oder Diagnosepaketen verhindern.
4. Änderung, Rekonfiguration, Neustart und Rücksetzung für jeden Schlüssel testen.

3. Abhängigkeiten, Dienste und Versionsverträglichkeit

Abhängigkeiten werden so eng wie nötig und so flexibel wie möglich beschrieben. Zyklische und nur implizite Kopplungen werden vermieden.

1. Benötigte Plattformdienste, Datenbanken und andere Dogus identifizieren.
2. Kompatible Versionsbereiche und Startreihenfolge festlegen.
3. Verhalten bei fehlender, veralteter oder vorübergehend nicht erreichbarer Abhängigkeit definieren.
4. Installations-, Upgrade- und Ausfallszenarien mit den Abhängigkeiten testen.

4. Registry-Struktur, Gültigkeitsbereiche und Datenarten

Die Registry enthält zentrale Zustands- und Konfigurationswerte. Direkte Änderungen ohne Verständnis können die Plattform beeinträchtigen.

1. Instanzweite, Dogu-spezifische und laufzeitbezogene Bereiche voneinander abgrenzen.
2. Konfiguration, Metadaten, Versionen, Abhängigkeiten und interne Zustände zuordnen.
3. Lesende Werkzeuge und vorgesehene Verwaltungswege für jeden Bereich bestimmen.
4. Werte mit besonderem Schutzbedarf oder hoher Betriebswirkung kennzeichnen.

5. Startlogik, Migrationen und Gesundheitsprüfung

Der Startprozess bleibt idempotent und diagnostizierbar. Datenmigrationen, Konfigurationsübernahme und Anwendungsstart werden kontrolliert verkettet.

1. Vorbedingungen und verfügbare Abhängigkeiten zu Beginn prüfen.
2. Konfiguration aus der Registry lesen, validieren und in Anwendungsform überführen.
3. Datenmigrationen versioniert, wiederholbar und mit Abbruchschutz ausführen.
4. Anwendung starten und Healthcheck erst nach tatsächlicher Betriebsbereitschaft erfolgreich melden.

6. Goss-, Integrations- und Lifecycle-Tests

Tests prüfen nicht nur, ob ein Prozess läuft. Konfiguration, Ports, Dateien, Anmeldung, Persistenz und Upgradepfade werden abgedeckt.

1. Statische und containerinterne Prüfungen für Dateien, Prozesse, Ports und Benutzer definieren.
2. Installation in einer frischen Testinstanz automatisiert durchführen.
3. Anmeldung, Navigation, Konfiguration, Datenpersistenz und Abhängigkeiten testen.
4. Upgrade, Neustart, Rekonfiguration und Wiederherstellung als Lifecycle-Szenarien ergänzen.

Praxisübungen

• Review und Korrektur einer unvollständigen dogu.json
• Entwurf von Konfigurationsschlüsseln einschließlich Geheimnisbehandlung
• Auflösung eines Versions- und Abhängigkeitskonflikts
• Test von Rekonfiguration und Healthcheck-Verhalten

Arbeitsweise

Schemaarbeit, Konfigurationsentwurf und Lifecycle-Tests werden an einer gemeinsamen Beispielbeschreibung durchgeführt.