Die Prinzipien guter Architekturdokumentation sind den meisten bekannt. Doch die Infrastruktur bleibt dabei oft unbeachtet oder wird sogar nur von wenigen “Wissenden” verstanden. Gerade bei komplexen Systemen ist das Festhalten von Lösungskonzepten und Entscheidungen auf der Infrastrukturebene einer Anwendung wichtig, um die Architektur nachzuvollziehen und die Software weiterentwickeln zu können. Dieser Beitrag richtet sich an Entwicklungsteams, die Schwierigkeiten haben, Infrastrukturthemen in ihre Dokumentation zu integrieren. Er bietet zudem Einsichten für Platform Engineers und crossfunktionale Teams, die ihre eigene Infrastruktur verantworten. Unter Infrastruktur verstehen wir in der Software-Entwicklung etwas vereinfacht alles, was eine Anwendung so “zum Leben braucht”. Und was Entwicklungsteams, anders als fachliche Funktionalität, üblicherweise nicht selbst verantworten. Analog zur Infrastruktur einer Stadt wie ÖPNV, Strom und Wasser fallen hierunter z. B. Netzwerke, Speicher- und Rechenkapazitäten, aber auch API-Gateways und Messaging Middleware, wobei sich letztere mit dem Begriff Anwendungsinfrastruktur abgrenzen lassen.

Anja Kammer und Stefan Zörner:
Infrastruktur in der Architektur-Dokumentation
Beitrag in Informatik Aktuell
online erschienen im Oktober 2024

Artikel online lesen