n diesem Vortrag berichtet der Sprecher von seinen Erfahrungen, Erfolgen und Fehlern mit dem arc42-Architekturtemplate in einem DevOps-Team im Konzernumfeld mit Produktentwicklungsfokus. Produktentwicklung ist geprägt von kurzen Iterationszyklen und wird darum gerne agil betrieben, wie im Team des Sprechers. Dort wurde die vorhandene unstrukturierte Dokumentation in das arc42-Template überführt und in einem Wiki abgelegt. Im Laufe der Zeit stellte sich heraus, dass das Tooling eine entscheidende Rolle für die Qualität der Dokumentation bedeutet und deswegen auf Docs-as-Code umgestellt. Im Laufe des Vortrags wird auf die wichtigsten Entscheidungspunkte für die aktuelle Iteration der technischen Softwarearchitektur eingegangen. Darunter unter anderem der Umgang mit "Entwicklerprosa", veralteter Dokumentation und der für ein DevOps-Team besonders wichtigen Architekturentscheidungen. Die Einbindung in das methodische Vorgehen Kanban wurde mit arc42 und einer Microsite basierend auf AsciiDoc möglich. Nicht ausgespart werden die gemachten Fehler, wie zum Beispiel fehlende Qualitätssicherung erstellter Dokumentation oder die Vermischung von fachlichen und technischen Themen.

1. arc42 in einem echten DevOps Team
Lessons Learned
DB Systel GmbH | Johannes Dienst | @JohannesDienst

2. Digitalpartner der
Deutschen Bahn
DB Systel GmbH | Johannes Dienst | @JohannesDienst 2

3. DB Content Hub
DB Systel GmbH | Johannes Dienst | @JohannesDienst 3
‒ Content as a Service (CaaS)
‒ Headless CMS
‒ Gehosted in der Cloud
‒ You build it, you run it!

4. Produktentwicklung
DB Systel GmbH | Johannes Dienst | @JohannesDienst 4

5. Die Kosten schlechter Dokumentation
DB Systel GmbH | Johannes Dienst | @JohannesDienst 5Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

6. Die Kosten schlechter Dokumentation
DB Systel GmbH | Johannes Dienst | @JohannesDienst 6Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

7. arc42
DB Systel GmbH | Johannes Dienst | @JohannesDienst 7

8. arc42
DB Systel GmbH | Johannes Dienst | @JohannesDienst 8

9. Technische Architektur in einem DevOps Team
DB Systel GmbH | Johannes Dienst | @JohannesDienst 9
Betriebshandbuch
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

10. Must Haves
DB Systel GmbH | Johannes Dienst | @JohannesDienst 10
‒ Einführung und Ziele
‒ Randbedingungen
‒ Kontextabgrenzung
‒ (Bausteinsicht)
‒ (Verteilungssicht)
‒ Querschnittliche Konzepte
‒ Entwurfsentscheidungen
‒ Risiken und technische Schulden
‒ Glossar

11. Glossar
DB Systel GmbH | Johannes Dienst | @JohannesDienst 11
Content
Asset
Content
Type
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

12. Ein Wiki ist geboren
DB Systel GmbH | Johannes Dienst | @JohannesDienst 12Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

13. Technische Architekturdokumentation != Tutorial
DB Systel GmbH | Johannes Dienst | @JohannesDienst 13Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

14. Das Wiki ist ein Problemkind
DB Systel GmbH | Johannes Dienst | @JohannesDienst 14Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

15. Das Wiki ist ein Problemkind
DB Systel GmbH | Johannes Dienst | @JohannesDienst 15Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

16. Sprung zu Docs-As-Code
DB Systel GmbH | Johannes Dienst | @JohannesDienst 16Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

17. Vorteile von Docs-As-Code
DB Systel GmbH | Johannes Dienst | @JohannesDienst 17
VonFreeSoftware
Foundation-[1],FAL,
https://commons.wikime
dia.org/w/index.php?curi
d=53428398
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

18. Vorteile von Docs-As-Code
DB Systel GmbH | Johannes Dienst | @JohannesDienst 18Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

19. Vorteile von Docs-As-Code: Docs Review
DB Systel GmbH | Johannes Dienst | @JohannesDienst 19
main
adr-042
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

20. AsciiDoc > Markdown
DB Systel GmbH | Johannes Dienst | @JohannesDienst 20
Standard
Includes
Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

21. Dokumentation im Konzernumfeld
DB Systel GmbH | Johannes Dienst | @JohannesDienst 21Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com
docToolchain

22. Docs-As-Code und arc42: Eine Liebesgeschichte
DB Systel GmbH | Johannes Dienst | @JohannesDienst 22

23. Docs-As-Code und arc42: Eine Liebesgeschichte
DB Systel GmbH | Johannes Dienst | @JohannesDienst 23

24. Veraltete Dokumentation
DB Systel GmbH | Johannes Dienst | @JohannesDienst 24Icons made by Freepik, Good Ware, Sprang and Smashicons from www.flaticon.com

25. Entwurfsentscheidungen
DB Systel GmbH | Johannes Dienst | @JohannesDienst 25

26. ADR-003: Staging- vs Cluster-Umgebung für CMS
Wir verwenden zwei Umgebungen (IAT, Prod). Diese werden als Cluster aufgebaut.
DB Systel GmbH | Johannes Dienst | @JohannesDienst 26
Status
BESCHLOSSEN
Kontext
Es wird eine Lösung gesucht, um Skalierbarkeit für das gesamte System sicherzustellen. Das Ziel ist es, potentiell
Dutzende von Kunden mit Tausenden Requests pro Sekunde zu bedienen.
Konsequenzen
Änderung der System-Architektur notwendig
‒ Abbau der beiden Public Instanzen
‒ Dekonfigurieren von Push Publishing
Es wird keine Umgebung zur Verfügung gestellt, auf der Content gepusht wird
Alternativen
Cluster-Lösung
‒ Betrieb des CMS im Cluster
Push Publishing
‒ Verwendung für mehrere Stages

27. Entwurfsentscheidungen
DB Systel GmbH | Johannes Dienst | @JohannesDienst 27

28. DB Systel GmbH | Johannes Dienst | @JohannesDienst 28
Welche zwei Fragen sind noch offen?
Johannes.Dienst@deutschebahn.com
@JohannesDienst

29. DB Systel GmbH | Johannes Dienst | @JohannesDienst 29
Links
https://arc42.org/
https://leanpub.com/arc42byexample
https://www.dokchess.de/
https://github.com/joelparkerhenderson/architecture_decisio
n_record