Die häufigste Beschwerde von Engineers, die Microservice-Teams beitreten, dreht sich nicht um Codequalität oder technische Komplexität. Es geht um Orientierung. Sie wissen nicht, wo Dinge sind, was was aufruft oder welche Services in ihrer Verantwortung liegen.
Engineering-Onboarding-Studien in mittelgroßen Organisationen identifizieren konsistent denselben Engpass: Neue Engineers verbringen den Großteil ihrer ersten zwei Wochen damit, Wissen von Senior-Kollegen zu extrahieren — Fragen zu stellen, die keine Person beantworten sollte. „Was ruft den Payment-Service auf?“ ist eine Abhängigkeitskartenfrage. „Wer besitzt den Notification-Service?“ ist eine Ownership-Kartenfrage. Keine davon sollte eine Slack-Nachricht erfordern. Die Voraussetzung ist eine gut gepflegte Map — und Microservice-Architektur zu dokumentieren in YAML im Git ist die Art, wie man eine baut, die aktuell bleibt.
Was neue Engineers zur Orientierung brauchen
- Welche Services existieren und was tun sie?
- Wie verbinden sich die Services? Upstream- und Downstream-Abhängigkeiten, visuell navigierbar.
- Wofür bin ich verantwortlich? Services gefiltert auf das Team des neuen Engineers.
- Was wird deprecated? Damit sie nicht auf Services aufbauen, die ausgemustert werden.
- Wen kontaktiere ich für X? Service-Eigentümerschaft, die auf ein Team verweist.
Eine interaktive Service-Map beantwortet alle fünf Fragen ohne eine einzige Slack-Nachricht. Der Unterschied zwischen einem neuen Engineer, der in 3 Tagen produktiv wird, und einem, der 3 Wochen braucht. Der praktische Leitfaden zur Microservice-Abhängigkeitskartierung beschreibt die vollständige Mechanik des Aufbaus einer solchen Map.
Die Onboarding-Aufgabe, die skaliert
Die effektivste Onboarding-Aufgabe für neue Engineers in Microservice-Systemen: Gib ihnen die Service-Map und bitte sie, eine Service-Definition zu aktualisieren. Das zwingt sie, das YAML-Schema zu lesen, zu verstehen, wie Abhängigkeiten deklariert werden, die Visualisierung zu navigieren und mindestens einen Service im Detail zu identifizieren. Es dauert eine Stunde. Am Ende verstehen sie, wie das Dokumentationssystem funktioniert — und haben dazu beigetragen.
Service Map generiert diese interaktive Visualisierung automatisch aus YAML-Service-Definitionen. Die Filter-nach-Team-Funktion lässt neue Engineers sofort den Graphen auf die Services eingrenzen, die sie besitzen. Einmaliger Kauf, keine SaaS-Gebühr.
Verwandte Artikel: Microservice-Architektur dokumentieren · Leitfaden zur Microservice-Abhängigkeitskartierung
