Skip to content
This repository has been archived by the owner on Jul 15, 2023. It is now read-only.

Latest commit

 

History

History
58 lines (23 loc) · 3.07 KB

architecture.md

File metadata and controls

58 lines (23 loc) · 3.07 KB
Raw

Architecture

Architecture

Main Components:

The Device Silhouette solution is comprised from the following components:

  1. Messaging broker

Being used to send messages and receive messages to/from the device. This project can support the usage of any messaging broker by implementing a Device Communication provider. The provider is implemented as an interface and can be implemented as a provider for additional messaging broker technologies like Kafka, Event Hub, RabbitMQ etc. In this current repro there is a provider implemented for Azure IoT Hub.

  1. Service Fabric Cluster

This is the service side, runs in the cloud, comprised from a few microservices, listed below.

  1. Long term persistency storage

The storage where messages are being persisted for long term and analytics. Implemented as an interface so it can be extended to support any desired storage. Currently implemented in this repro for Azure blob storage.

Service Fabric microservices:

  1. Device State Management Service REST API (Stateless)

Enables external applications to communicate with the Device State Repository. Using the Device State Management Service an external application can get the latest state or send command to a device to change its states.

  1. State Processor Service (Stateless)

Receive state get/set requests and process those requests. All operations are Asynchronous. The State Processor Service receives requests from external applications through the Device State Management Service REST API, it also receives requests from devices through the Device Communication Provider endpoints. Then it executes the requests by communicating directly with the State Repository Service. The communication with the device is done through Device Communication Provider.

  1. Device State Repository (stateful Actor based)

Holds the Silhouette itself. It's a statful Actor based service that saves the list of the last messages sent to/from the device.

  1. Feedback Service (Stateless)

Responsible for check messages delivery status from IoT Hub, meaning for messages sent to the device it will look for acknowledgment/non-acknowledgment and update the Device State Repository with the latest message delivery status.

  1. Device Communication Provider (Stateless)

Interface to enable the communication between the Cloud and the Device. Its purpose is to enable Silhouette customers to choose the device communication technology from the variety of existing market messaging technologies, such as IoT Hub, Event Hubs or Kafka. Since each of the technologies supports different communication protocols, it also means the customer is able to choose the communication protocol by choosing a messaging technology that supports the desired protocol.

  1. Storage Provider Service (Stateless)

Persists all the messages to a long term persistency storage. Implemented as an interface that can be extended to any desired storage. In this current repro there is a provider implemented for Azure Blob Storage.