Files
smart-city-digital-twin-mar…/architecture-multi-cb.md

134 lines
7.5 KiB
Markdown

# Architecture Smart City - Multi Context Broker (Updated 2026-05-06)
## Principe : 1 IoT-Agent, 1 QuantumLeap, 1 CrateDB par Context Broker
```
┌─────────────────────────────────────────────────────────────────────────────┐
│ Smart City Simulator (Python) │
│ Publie sur 3 brokers MQTT avec format IoT-Agent JSON │
└──────────┬────────────────────┬──────────────────────┬───────────────────┘
│ │ │
▼ ▼ ▼
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ EMQX Broker │ │ Mosquitto Broker │ │ BunkerM Broker │
│ (port 11883) │ │ (port 1883) │ │ (port 1900) │
└────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘
│ │ │
▼ ▼ ▼
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ IoT-Agent-EMQX │ │IoT-Agent-Mosquitto│ │IoT-Agent-BunkerM │
│ Port: 4041 │ │ Port: 4042 │ │ Port: 4043 │
│ Apikey: smart- │ │ Apikey: smart- │ │ Apikey: smart- │
│ city-api-key │ │ city-api-key │ │ city-api-key │
└────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘
│ │ │
└───────────────────────┴──────────────────────┘
┌───────────────┴───────────────┐
│ │
▼ ▼
┌─────────────────────┐ ┌─────────────────────┐
│ Orion-LD │ │ Stellio │
│ (port 1026) │ │ (port 8080) │
│ MongoDB backend │ │ (API Gateway) │
└─────────┬───────────┘ └─────────┬───────────┘
│ │
▼ ▼
┌─────────────────────┐ ┌─────────────────────┐
│ QuantumLeap-Orion │ │ QuantumLeap-Stellio │
│ (port 8668) │ │ (port 8669) │
│ → CrateDB-Orion │ │ → CrateDB-Stellio │
└─────────┬───────────┘ └─────────┬───────────┘
│ │
▼ ▼
┌─────────────────────┐ ┌─────────────────────┐
│ CrateDB-Orion │ │ CrateDB-Stellio │
│ (port 5432/4200) │ │ (port 5433/4201) │
│ DB: quantumleap │ │ DB: quantumleap_ │
│ │ │ stellio │
└─────────┬───────────┘ └─────────┬───────────┘
│ │
└───────────────────────┬─────────┘
┌─────────────────────┐
│ Grafana │
│ (port 3001) │
│ 2 Datasources: │
│ - CrateDB-Orion │
│ - CrateDB-Stellio│
└─────────────────────┘
```
## Services déployés (par Context Broker)
### Pour Orion-LD
| Service | Container | Port | Description |
|---------|-----------|------|-------------|
| **IoT-Agent** | smart-city-iot-agent-emqx | 4041 | Reçoit MQTT EMQX |
| **Context Broker** | smart-city-orion-ld | 1026 | Orion-LD (NGSI-v2) |
| **QuantumLeap** | smart-city-quantumleap | 8668 | Time-series pour Orion |
| **CrateDB** | smart-city-cratedb | 5432/4200 | Stockage Orion |
### Pour Stellio
| Service | Container | Port | Description |
|---------|-----------|------|-------------|
| **IoT-Agent** | smart-city-iot-agent-* | 4041-4043 | Les mêmes (envoient aussi à Stellio) |
| **Context Broker** | stellio-api-gateway | 8080 | Stellio (NGSI-LD) |
| **QuantumLeap** | smart-city-quantumleap-stellio | 8669 | Time-series pour Stellio |
| **CrateDB** | smart-city-cratedb-stellio | 5433/4201 | Stockage Stellio |
## Configuration des IoT-Agents (pour 2 Context Brokers)
Chaque IoT-Agent doit avoir **2 services** (un pour Orion, un pour Stellio) :
```json
// Service 1: Orion-LD
{
"apikey": "smartcity-api-key",
"cbroker": "http://smart-city-orion-ld:1026",
"resource": "/",
"type": "AirQualityObserved"
}
// Service 2: Stellio
{
"apikey": "smartcity-api-key-stellio",
"cbroker": "http://stellio-api-gateway:8080",
"resource": "/",
"type": "AirQualityObserved"
}
```
## Fichiers de configuration (nouveaux)
1. `docker-compose.quantumleap-stellio.yml` - QuantumLeap pour Stellio
2. `docker-compose.cratedb-stellio.yml` - CrateDB pour Stellio
3. Mise à jour `docker-compose.iot-agent.yml` - Ajouter services Stellio
## Sous-domaines (Traefik)
- `quantum-leap-stellio.digitribe.fr` → QuantumLeap-Stellio (port 8669)
- `cratedb-stellio.digitribe.fr` → CrateDB-Stellio (port 4201)
## Avantages de cette architecture
1. **Isolation** : Problème sur Stellio n'impacte pas Orion-LD
2. **Scalabilité** : Chaque Context Broker a ses propres ressources
3. **Clarté** : 1 flux = 1 pipeline complet
4. **Comparaison** : Possibilité de comparer performances Orion vs Stellio
## Inconvénients
1. **Complexité** : Plus de conteneurs à gérer
2. **Ressources** : Plus de RAM/CPU pour les CrateDB supplémentaires
3. **Maintenance** : Plus de configurations à maintenir à jour
## Recommandation
Pour un environnement de **production**, l'architecture isolée est recommandée.
Pour un **POC/test**, on peut simplifier en utilisant un seul QuantumLeap/CrateDB pour les deux Context Brokers.
---
*Dernière mise à jour : 06 Mai 2026, 17h45*