
In der modernen Softwarearchitektur ist das Verständnis der Interaktion zwischen physischer Hardware und Cloud-Diensten von entscheidender Bedeutung. Dieses Tutorial untersucht eine spezifische architektonische Visualisierung: das Container-Diagramm der Ebene 2für ein IoT-Gateway-System. Unter Verwendung der C4-Modellmethodik in einer VPasCode-Umgebung zerlegen wir, wie komplexe eingebettete Systeme, lokale Datenbanken und externe Datenströme in einer einzigen, zusammenhängenden Ansicht dargestellt werden können.
Im Gegensatz zu einem kontextbezogenen Diagramm auf hoher Ebene, das ein System als Blackbox darstellt, „öffnet” ein Diagramm der Ebene 2 die Box. Es enthüllt die internen Laufzeitumgebungen, Prozessgrenzen und die spezifischen Technologien (Sprachen, Datenbanken), die die Anwendung antreiben. Im Folgenden gehen wir durch die Erstellung dieses Diagramms, die getroffenen spezifischen Modellierungsentscheidungen und die technische Logik hinter den Beziehungen.
Das C4-Modell: Warum Container verwenden?
Das C4-Modell ist ein hierarchischer Ansatz zur Dokumentation der Softwarearchitektur. Es besteht aus vier Ebenen:
- Ebene 1 (Kontext):Zeigt das System und seine Benutzer.
- Ebene 2 (Container):Zeigt die technischen Bausteine auf hoher Ebene (Container), aus denen das System besteht.
- Ebene 3 (Komponente):Zeigt die interne Struktur eines Containers.
- Ebene 4 (Code):Zeigt die tatsächlichen Code-Klassen und Abhängigkeiten.
Dieses Tutorial konzentriert sich auf Ebene 2. Im bereitgestellten Beispiel modellieren wir ein IoT-Gateway-System. Dies ist eine kritische Grenze, da sie die Netzwerkgrenze darstellt, an der physische Sensoren auf die Cloud treffen.
Schritt-für-Schritt: Erstellung des Diagramms
Um diese Architektur nachzubauen, verwenden wir PlantUML-Code. Dieser Code wird vom VPasCode-Editor analysiert, um das visuelle Diagramm auf der rechten Seite darzustellen.
1. Die Bühne vorbereiten: Includes und Layout
Zuerst müssen wir die C4 PlantUML-Bibliothek laden. Diese Bibliothek bietet die Standardformen (Personen, Container, Boxen) und Stilregeln.
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
LAYOUT_WITH_LEGEND()
Der LAYOUTMITLEGEND()Befehl ist eine spezifische Anweisung, die dem Renderer mitteilt, die Elemente automatisch zu organisieren und einen Schlüssel zu generieren, der erklärt, was die Formen bedeuten (z. B. „Person” vs. „Container”).
2. Definieren der Akteure und externen Systeme
Bevor wir definieren, was sich innerhalb des Gateways befindet, müssen wir festlegen, wer damit interagiert und womit es außerhalb kommuniziert.
Person(heimbesitzer, "Heimbesitzer", "Überwacht und steuert das Hausklima.")
System_Ext(wetter_api, "Nationales Wetter-API", "Stellt externe Vorhersagen für die Umgebungstemperatur bereit.")
- Person(heimbesitzer…):Stellt den menschlichen Benutzer dar. Die Bezeichnung beschreibt deren Rolle.
- SystemExt(wetterapi…):Stellt ein System außerhalb unserer Grenze dar. Wir verwenden
SystemExtstatt eines Standard-Systemum anzudeuten, dass der Quellcode nicht unter unserer Kontrolle steht (es handelt sich um eine API eines Drittanbieters).
3. Die Systemgrenze und Container
Dies ist der Kern des Diagramms. Wir definieren ein SystemGrenzeum alles zu gruppieren, was innerhalb der IoT-Gateway-Hardware geschieht.
System_Grenze(gateway_grenze, "IoT-Gateway-System") {
Container(firmware, "Core-Daemon-Dienst", "C++ / FreeRTOS", "Abfragt direkte physische Sensor-Hardware-Register über I2C.")
ContainerDb(local_db, "Telemetrie-Cache", "SQLite-Datei", "Puffert Sensor-Metriken vorübergehend während breiter Verbindungsunterbrechungen.")
Container(mqtt_client, "Cloud-Sync-Client", "Go-Binärdatei", "Sendet strukturierte Telemetrie-Pakete über einen sicheren WAN-Socket nach oben.")
}
Beachten Sie die spezifischen Typen von Containern, die verwendet werden:
- Container(firmware…):Dies stellt die auf dem Mikrocontroller laufende Firmware dar. Die Beschreibung hebt die Low-Level-Interaktion hervor: Abfragen von Hardware-Registern über
I2C. - ContainerDb(localdb…):Wir verwenden
ContainerDbspeziell für Datenbanken. Die Beschreibung erklärt das „Store-and-Forward“-Muster: Puffern von Daten, wenn das Internet ausfällt. - Container(mqttClient…):Dies stellt einen Client-Prozess dar (wahrscheinlich als separater Thread oder Sidecar-Prozess ausgeführt), der für die Cloud-Konnektivität verantwortlich ist.
4. Definieren von Beziehungen (die „Linien“)
Schließlich zeichnen wir die Pfeile. In PlantUML steht der RelBefehl für „Beziehung“. Die Syntax ist im Allgemeinen Rel(Quelle, Ziel, "Beschriftung", "Protokoll").
Rel(Heimbesitzer, Firmware, "Steuert lokal über", "BLE")
Rel(Firmware, lokale_db, "Schreibt Metriken in", "SQL / IPC")
Rel(mqtt_client, lokale_db, "Abfrage zurückgestellter Frames aus", "SQL / IPC")
Rel(mqtt_client, weather_api, "Ruft Umgebungsstatus ab über", "HTTPS")
Wichtige architektonische Erkenntnisse aus diesen Beziehungen:
- BLE (Bluetooth Low Energy):Der Heimbesitzer interagiert direkt über Bluetooth mit der Firmware, nicht über die Cloud.
- IPC (Inter-Prozess-Kommunikation):Beachten Sie, dass die Firmware und der MQTT-Client über
SQL / IPCDies impliziert, dass die Datenbank eine lokale Datei (SQLite) ist, die als Brücke zwischen dem C++-Firmware-Prozess und dem Go-Client-Prozess fungiert. - HTTPS:Der Cloud-Client kommuniziert mit der Wetter-API über das öffentliche Internet.
Technische Analyse: Das Store-and-Forward-Muster
Dieses Diagramm veranschaulicht ein klassisches Muster im IoT-Engineering: Store-and-Forward. Im Diagramm ist der Telemetrie-Cache(SQLite) die kritische Komponente. Er entkoppelt die Datenerfassung (Firmware) von der Datenübertragung (MQTT-Client).
Ohne diesen Container wären bei einem Ausfall des Internets die Sensordaten verloren gegangen. Durch die Einführung des ContainerDbstellt das System die Datenintegrität sicher. Das Diagramm verdeutlicht deutlich, dass der „Cloud-Sync-Client“ über Logik verfügen muss, um vor dem Senden neuer Daten nach „zurückgestellten Frames“ in der Datenbank zu fragen.
Fazit
Durch die Nutzung von VPasCode und der C4 PlantUML-Bibliothek haben wir eine komplexe Hardware-Software-Architektur in ein klares, lesbares Diagramm verwandelt. Die Level-2-Ansicht vermittelt nicht nur “wer das System verwendet, sondern “wie es intern funktioniert – wobei die Trennung der Anliegen zwischen Sensor-Abfrage, lokaler Datenspeicherung und Cloud-Synchronisation hervorgehoben wird.










