UML-Verteilungsdiagramme

Ein Verteilungsdiagramm bildet Software auf Hardware ab. Es ist das einzige UML-Diagramm über die physische Welt - Maschinen, Container, Netzwerkverbindungen - und es beantwortet eine Frage, die kein anderes beantwortet: wenn diese Kiste abbrennt, was hört auf zu funktionieren?

Es ist außerdem das Diagramm, um das am ehesten jemand bittet, der nicht entwickelt. Sicherheitsprüfungen, Notfallwiederherstellungspläne, Fragen zum Speicherort von Daten und Kostengespräche beginnen alle bei „wo läuft das eigentlich und was spricht mit was“.

Verteilungsdiagramme verfallen schneller als jede andere Art, weil Infrastruktur sich wöchentlich ändert und Diagramme nicht. Ein solches Diagramm bleibt nur nützlich, wenn Sie es auf der Höhe zeichnen, die sich langsam ändert.

Zeichnen Sie Topologie, keine Inventarliste. „Kubernetes-Cluster“ bleibt jahrelang wahr. „Drei m5.large-Instanzen in eu-central-1b“ ist im nächsten Quartal falsch und gehört in das Infrastructure-as-Code-Repository, den einzigen Ort, an dem es richtig sein kann.

Beschriften Sie die Verbindungen. Eine Linie, die nichts sagt, ist fast wertlos; eine Linie, die TCP 5432, HTTPS oder AMQP over TLS sagt, ist der Grund, aus dem ein Sicherheitsprüfer das Diagramm überhaupt liest. Dasselbe gilt für Vertrauensgrenzen - wenn eine Verbindung Ihr Netz in Richtung eines fremden verlässt, sagen Sie es.

Zeichnen Sie Multiplizität dort, wo sie zählt. Ein Knoten kann eine Multiplizität tragen wie eine Klasse. 1..* am Anwendungsknoten und 1 an der Datenbank sagt etwas Echtes über die Ausfallmodi des Systems.

1. Unbeschriftete Kommunikationspfade.Protokoll und Port sind der Inhalt. Ohne sie sagt eine Linie nur „diese sind verbunden“.
2. Komponenten dort gezeichnet, wo Artefakte hingehören. Knoten beherbergen Dateien. Setzen Sie checkout.jar auf den Knoten und lassen Sie Checkout im Komponentendiagramm.
3. Instanzdetails, die nicht wahr bleiben können. Hostnamen und Instanzgrößen gehören in den Code, nicht in ein Diagramm.
4. Keine Vertrauensgrenzen. Wenn einige Knoten Ihnen gehören und andere einem Dritten, ist diese Unterscheidung oft das Wichtigste auf der Seite.
5. Ein Diagramm pro Umgebung. Zeichnen Sie die Produktion. Notieren Sie Unterschiede im Text; zeichnen Sie nicht vier fast identische Diagramme, die auseinanderlaufen.