Seminar Kroki

Diagramme als Code planbar einführen

Kroki vereinheitlicht die Erzeugung textbasierter Diagramme über einen gemeinsamen Dienst. Das Seminarprogramm behandelt deshalb nicht nur einzelne Diagrammsprachen, sondern den vollständigen Arbeitsweg von der versionierten Quelle über Dokumentationssysteme und Automatisierung bis zum sicheren und beobachtbaren Plattformbetrieb.

Die Lernwege sind modular aufgebaut. Fachliche Teams können gezielt Diagrammsprachen und Dokumentationsworkflows auswählen. Entwicklungs- und Betriebsteams ergänzen API, Container, Kubernetes, Sicherheit und Monitoring. Kompakt- und Intensivvarianten verdichten die Inhalte für Projekte mit engem Zeitrahmen.

Inhaltsübersicht

• Grundlagen, API und reproduzierbare Diagrammerzeugung
• Architektur-, Prozess-, Daten-, Netzwerk-, Hardware- und Visualisierungsdiagramme
• Integration in AsciiDoc, Markdown, GitLab und Sphinx
• CLI-, Skript- und CI/CD-Automatisierung
• Docker-, Podman- und Kubernetes-Betrieb
• Sicherheit, Härtung, Performance, Monitoring und Fehleranalyse
• Migration, Teamstandards, Governance und unternehmensweite Einführung
• Kompakte und intensive Lernwege

Seminargruppen

Der Einstieg erfolgt über Grundlagen und API. Darauf folgen fachliche Vertiefungen für Architektur, Mermaid und BPMN, Datenmodelle, Datenvisualisierung, Netzwerke, Hardware sowie Text- und ASCII-Diagramme. Die zweite Gruppe verbindet Diagrammquellen mit Dokumentationsplattformen, CLI, Skripten und CI/CD. Die dritte Gruppe behandelt Eigenbetrieb, Sicherheit, Kubernetes, Skalierung, Monitoring und Fehleranalyse. Migration, Governance und die Projektwerkstatt schließen den organisatorischen Lebenszyklus.

Empfohlene Reihenfolge

1. Schritt 1: Grundverständnis aufbauen Zuerst werden Grundlagen und erste Diagramme erarbeitet. Dadurch entstehen ein einheitliches Vokabular, nachvollziehbare Quellenstrukturen und belastbare Auswahlkriterien.
2. Schritt 2: API und Ausgabewege beherrschen Anschließend werden Endpunkte, Kodierung, Formate und Diagrammoptionen behandelt. Dieses Wissen bildet die technische Basis für Integrationen und Automatisierung.
3. Schritt 3: Passende Diagrammsprachen vertiefen Je nach Aufgabenbereich folgen Architektur-, Prozess-, Daten-, Netzwerk-, Hardware-, Visualisierungs- oder ASCII-orientierte Fachseminare.
4. Schritt 4: Dokumentationsworkflow integrieren Die Einbindung in AsciiDoc, Markdown, GitLab oder Sphinx wird mit Dateiablage, Vorschau, Build und Artefaktverwaltung verbunden.
5. Schritt 5: Automatisierung einführen CLI, Skripte und CI/CD standardisieren die Erzeugung, Prüfung und Bereitstellung der Diagramme.
6. Schritt 6: Eigenbetrieb absichern Docker- oder Podman-Self-Hosting wird vor Sicherheit und Härtung besucht. Konfiguration, Netzwerkgrenzen und Betriebsverantwortung sind dadurch bereits bekannt.
7. Schritt 7: Plattformbetrieb erweitern Kubernetes, Skalierung, Hochverfügbarkeit sowie Performance, Monitoring und Fehleranalyse folgen für produktive oder geschäftskritische Umgebungen.
8. Schritt 8: Organisation und Lebenszyklus verankern Migration, Teamstandards, Governance und die Projektwerkstatt übertragen die Technik in verbindliche Prozesse, Rollen und Betriebsübergaben.

Kompakte und intensive Lernwege

Das dreitägige Kompaktseminar verbindet Diagramme, API und Self-Hosting für einen schnellen Praxisüberblick. Das Intensivseminar zu Diagrammsprachen und Dokumentationsworkflows konzentriert sich auf Erstellung und Publikation. Das Intensivseminar zu Plattformbetrieb, Integration und Automatisierung bündelt Betrieb, Sicherheit und Auslieferung. Das Komplettprogramm fasst das gesamte Portfolio in fünf Tagen zusammen und stellt die durchgängige Einführung in den Mittelpunkt.

Auswahl nach Aufgabenbereich

• Redaktion und Dokumentation: Grundlagen, Sprachen, Dokumentationsintegration und Governance
• Softwareentwicklung und Architektur: API, Architekturdiagramme, Datenmodelle, Automatisierung und Qualitätssicherung
• DevOps und Plattformbetrieb: Self-Hosting, Sicherheit, Kubernetes, Monitoring und CI/CD
• Technische Projektleitung: Kompaktseminar, Migration, Governance und Projektwerkstatt
• Gemischte Einführungsteams: Komplettprogramm oder Kombination aus fachlichem und betrieblichem Intensivseminar