
Trong kiến trúc phần mềm hiện đại, việc hiểu rõ sự tương tác giữa phần cứng vật lý và các dịch vụ đám mây là vô cùng quan trọng. Hướng dẫn này khám phá một cách trực quan hóa kiến trúc cụ thể: sơ đồ Sơ đồ Container Cấp độ 2cho hệ thống cổng IoT. Sử dụng phương pháp mô hình C4 trong môi trường VPasCode, chúng ta phân tích cách biểu diễn các hệ thống nhúng phức tạp, cơ sở dữ liệu cục bộ và các luồng dữ liệu bên ngoài trong một cái nhìn thống nhất và toàn diện.
Khác với sơ đồ ngữ cảnh cấp cao thể hiện hệ thống như một hộp đen, sơ đồ Cấp độ 2 “mở hộp” ra. Nó tiết lộ các môi trường chạy nội bộ, ranh giới quy trình và các công nghệ cụ thể (ngôn ngữ, cơ sở dữ liệu) đang vận hành ứng dụng. Dưới đây, chúng ta sẽ đi qua quá trình xây dựng sơ đồ này, các lựa chọn mô hình hóa cụ thể đã được thực hiện và logic kỹ thuật đằng sau các mối quan hệ.
Mô hình C4: Tại sao sử dụng Container?
Mô hình C4 là một cách tiếp cận phân cấp để tài liệu hóa kiến trúc phần mềm. Nó bao gồm bốn cấp độ:
- Cấp độ 1 (Ngữ cảnh):Thể hiện hệ thống và người dùng của nó.
- Cấp độ 2 (Container):Thể hiện các khối xây dựng kỹ thuật cấp cao (container) tạo nên hệ thống.
- Cấp độ 3 (Thành phần):Thể hiện cấu trúc nội bộ của một container.
- Cấp độ 4 (Mã nguồn):Thể hiện các lớp mã nguồn thực tế và các phụ thuộc.
Hướng dẫn này tập trung vào Cấp độ 2. Trong ví dụ được cung cấp, chúng ta đang mô hình hóa một hệ thống cổng IoT. Đây là một ranh giới quan trọng vì nó đại diện cho biên giới của mạng nơi các cảm biến vật lý gặp gỡ đám mây.
Từng bước: Xây dựng sơ đồ
Để tái tạo kiến trúc này, chúng tôi sử dụng mã PlantUML. Mã này được trình biên tập VPasCode phân tích để hiển thị sơ đồ trực quan ở bên phải.
1. Thiết lập nền tảng: Bao gồm và bố cục
Đầu tiên, chúng ta cần tải thư viện C4 PlantUML. Thư viện này cung cấp các hình dạng tiêu chuẩn (người, container, hộp) và các quy tắc định dạng.
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
LAYOUT_WITH_LEGEND()
Lệnh LAYOUTWITHLEGEND() là một chỉ dẫn cụ thể cho phép trình hiển thị tự động sắp xếp các phần tử và tạo ra một bảng chú giải giải thích ý nghĩa của các hình dạng (ví dụ: “Người” so với “Container”).
2. Xác định các vai trò và hệ thống bên ngoài
Trước khi xác định những gì nằm bên trong cổng, chúng ta phải xác định ai tương tác với nó và nó giao tiếp với những gì bên ngoài.
Person(homeowner, "Chủ nhà", "Giám sát và điều khiển khí hậu trong nhà.")
System_Ext(weather_api, "API Thời tiết Quốc gia", "Cung cấp dự báo nhiệt độ môi trường bên ngoài.")
- Person(homeowner…):Đại diện cho người dùng con người. Nhãn mô tả vai trò của họ.
- Hệ thốngExt(weatherapi…):Đại diện cho một hệ thống bên ngoài ranh giới của chúng ta. Chúng tôi sử dụng
Hệ thốngExtthay vì mộtHệ thốngđể chỉ ra rằng mã nguồn không nằm dưới sự kiểm soát của chúng ta (đó là một API của bên thứ ba).
3. Ranh giới hệ thống và các thành phần
Đây là phần cốt lõi của sơ đồ. Chúng tôi định nghĩa mộtHệ thốngBoundary để nhóm tất cả những gì xảy ra bên trong phần cứng Cổng IoT.
System_Boundary(gateway_boundary, "Hệ thống Cổng IoT") {
Container(firmware, "Dịch vụ Daemon Cốt lõi", "C++ / FreeRTOS", "Quét các thanh ghi phần cứng cảm biến vật lý trực tiếp qua I2C.")
ContainerDb(local_db, "Bộ đệm Telemetry", "Tệp SQLite", "Tạm thời đệm các chỉ số cảm biến trong thời gian mất kết nối rộng rãi.")
Container(mqtt_client, "Client Đồng bộ hóa Đám mây", "Go Binary", "Đẩy các gói telemetry có cấu trúc lên phía trước qua cổng WAN an toàn.")
}
Hãy chú ý đến các loại thành phần cụ thể được sử dụng:
- Container(firmware…): Đây đại diện cho phần mềm chạy trên vi điều khiển. Mô tả nhấn mạnh sự tương tác ở mức thấp: quét các thanh ghi phần cứng qua
I2C. - ContainerDb(localdb…): Chúng tôi sử dụng
ContainerDbcụ thể cho cơ sở dữ liệu. Mô tả giải thích mô hình “lưu trữ và chuyển tiếp”: đệm dữ liệu khi internet bị ngắt. - Container(mqttclient…): Đây biểu thị một tiến trình khách (có thể đang chạy dưới dạng luồng riêng biệt hoặc tiến trình sidecar) chịu trách nhiệm kết nối đám mây.
4. Xác định các mối quan hệ (Các “Đường”)
Cuối cùng, chúng ta vẽ các mũi tên. Trong PlantUML, từ Rel là viết tắt của “Mối quan hệ”. Cú pháp thường là Rel(Nguồn, Mục tiêu, "Nhãn", "Giao thức").
Rel(homeowner, firmware, "Điều khiển cục bộ qua", "BLE")
Rel(firmware, local_db, "Ghi chỉ số vào", "SQL / IPC")
Rel(mqtt_client, local_db, "Truy vấn các khung bị trễ từ", "SQL / IPC")
Rel(mqtt_client, weather_api, "Lấy trạng thái môi trường qua", "HTTPS")
Những hiểu biết kiến trúc quan trọng từ các mối quan hệ này:
- BLE (Bluetooth Low Energy): Người dùng nhà tương tác trực tiếp với phần mềm nhúng qua Bluetooth, không qua đám mây.
- IPC (Truyền thông giữa các tiến trình): Hãy lưu ý rằng phần mềm nhúng và khách MQTT tương tác với cơ sở dữ liệu qua
SQL / IPC. Điều này ngụ ý rằng cơ sở dữ liệu là một tệp cục bộ (SQLite) đóng vai trò cầu nối giữa tiến trình phần mềm nhúng C++ và tiến trình khách Go. - HTTPS: Khách đám mây trò chuyện với API Thời tiết qua internet công cộng.
Phân tích kỹ thuật: Mô hình Lưu trữ và Chuyển tiếp
Sơ đồ này minh họa một mẫu cổ điển trong kỹ thuật IoT: Lưu trữ và Chuyển tiếp. Trong sơ đồ, Bộ nhớ đệm Telemetry (SQLite) là thành phần then chốt. Nó tách rời việc thu thập dữ liệu (phần mềm nhúng) khỏi việc truyền dữ liệu (Khách MQTT).
Không có container này, nếu internet bị mất, dữ liệu cảm biến sẽ bị mất. Bằng cách giới thiệu ContainerDb, hệ thống đảm bảo tính toàn vẹn của dữ liệu. Sơ đồ truyền đạt rõ ràng rằng “Khách đồng bộ đám mây” phải có logic để truy vấn cơ sở dữ liệu tìm “các khung bị trễ” trước khi gửi dữ liệu mới.
Kết luận
Bằng cách sử dụng VPasCode và thư viện C4 PlantUML, chúng tôi đã chuyển đổi một kiến trúc phần cứng-phần mềm phức tạp thành một biểu đồ rõ ràng, dễ đọc. Chế độ xem Cấp độ 2 không chỉ truyền đạt hiệu quả “ai sử dụng hệ thống, mà còn “như thế nào hệ thống hoạt động bên trong—làm nổi bật sự phân tách các mối quan tâm giữa việc lấy mẫu cảm biến, lưu trữ dữ liệu cục bộ và đồng bộ hóa đám mây.










