feat(iot): Этапы 2-7 — MQTT auth, IoT API, EMQX, mqtt-bridge, E2E demo
Этап 2+4: internal/api/handler/iot_device_handler.go
- MQTTAuth: POST /internal/mqtt/auth (без JWT, для EMQX)
- CreateIoTDevice, ListIoTDevices, GetIoTDevice (c password), DeleteIoTDevice, UpdateIoTDevice
- crypto/subtle.ConstantTimeCompare против timing attacks
Этап 4: internal/api/router.go
- /v1/namespaces/{ns}/iot/devices CRUD
- /internal/mqtt/auth (без JWT middleware)
Этап 3: deployments/k8s/emqx.yaml
- EMQX 5.5.1, emqx.conf (HOCON) с HTTP auth backend
- Сервис exposure: 1883 (MQTT), 8083 (WS), 18083 (Dashboard)
Этап 3: iot/cmd/mqtt-bridge/main.go
- paho.mqtt.golang: подписка на +/telemetry/+
- amqp091-go: publish в iot.{namespace}.telemetry
- deployments/k8s/iot-mqtt-bridge.yaml
Этап 7: examples/IOT/ — E2E demo (main.tf, handler.py, README.md)
go.mod: добавлен github.com/eclipse/paho.mqtt.golang v1.5.1
go build ./... — ошибок нет
This commit is contained in:
Naeel
@@ -0,0 +1,271 @@
|
||||
// Создано: 2026-04-04
|
||||
// mqtt-bridge/main.go — сервис-мост: MQTT (EMQX) → RabbitMQ.
|
||||
//
|
||||
// Роль в архитектуре:
|
||||
// IoT Device → MQTT PUBLISH → EMQX → [mqtt-bridge подписан на "+/telemetry/+"] → RabbitMQ → event-dispatcher → function
|
||||
//
|
||||
// Логика:
|
||||
// 1. Подключиться к EMQX как MQTT клиент (credentials из env)
|
||||
// 2. Подписаться на топик "+/telemetry/+" (any namespace / telemetry / any device)
|
||||
// 3. При получении сообщения:
|
||||
// - Извлечь namespace из топика — первый сегмент до "/"
|
||||
// - Опубликовать в RabbitMQ queue "iot.{namespace}.telemetry"
|
||||
// - Payload передаётся as-is (JSON от устройства)
|
||||
// 4. Переподключаться к RabbitMQ при разрыве (reconnect loop)
|
||||
//
|
||||
// Конфигурация через env vars:
|
||||
// MQTT_BROKER_URL — tcp://emqx.sless.svc:1883
|
||||
// MQTT_USERNAME — username для подключения bridge к EMQX
|
||||
// MQTT_PASSWORD — пароль bridge клиента
|
||||
// RABBITMQ_URL — amqp://sless:sless123@rabbitmq.sless.svc.cluster.local:5672/
|
||||
//
|
||||
// ВАЖНО: bridge клиент должен проходить EMQX auth — нужен IoTDevice "iot-bridge" в namespace "sless-bridge".
|
||||
// Для MVP: выделить специальный namespace "sless-bridge" с устройством "bridge",
|
||||
// и использовать его credentials для подключения bridge сервиса.
|
||||
// Или: зарегистрировать bridge устройство через API и записать credentials в Secret.
|
||||
|
||||
package main
|
||||
|
||||
import (
|
||||
"context"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"log/slog"
|
||||
"os"
|
||||
"os/signal"
|
||||
"strings"
|
||||
"syscall"
|
||||
"time"
|
||||
|
||||
mqtt "github.com/eclipse/paho.mqtt.golang"
|
||||
amqp "github.com/rabbitmq/amqp091-go"
|
||||
)
|
||||
|
||||
// mqttBridgeConfig — конфигурация сервиса из env vars.
|
||||
type mqttBridgeConfig struct {
|
||||
MQTTBrokerURL string
|
||||
MQTTUsername string
|
||||
MQTTPassword string
|
||||
RabbitMQURL string
|
||||
}
|
||||
|
||||
// iotTelemetryMessage — структура сообщения публикуемого в RabbitMQ.
|
||||
// Оборачивает MQTT payload в envelope с метаданными.
|
||||
type iotTelemetryMessage struct {
|
||||
// Namespace — k8s namespace пользователя (из MQTT topic)
|
||||
Namespace string `json:"namespace"`
|
||||
// DeviceID — идентификатор устройства (из MQTT topic, последний сегмент)
|
||||
DeviceID string `json:"device_id"`
|
||||
// Topic — оригинальный MQTT topic
|
||||
Topic string `json:"topic"`
|
||||
// Payload — данные от устройства (JSON передаётся as-is / строка если не JSON)
|
||||
Payload json.RawMessage `json:"payload"`
|
||||
// ReceivedAt — время получения сообщения мостом (UTC)
|
||||
ReceivedAt string `json:"received_at"`
|
||||
}
|
||||
|
||||
func main() {
|
||||
log := slog.New(slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelInfo}))
|
||||
|
||||
cfg := loadBridgeConfig()
|
||||
|
||||
ctx, cancel := signal.NotifyContext(context.Background(), syscall.SIGTERM, syscall.SIGINT)
|
||||
defer cancel()
|
||||
|
||||
log.Info("starting iot-mqtt-bridge",
|
||||
"mqtt_broker", cfg.MQTTBrokerURL,
|
||||
"mqtt_username", cfg.MQTTUsername,
|
||||
)
|
||||
|
||||
// RabbitMQ connection с reconnect loop
|
||||
rabbitConn, err := connectRabbitMQWithRetry(ctx, cfg.RabbitMQURL, log)
|
||||
if err != nil {
|
||||
log.Error("failed to connect to RabbitMQ", "err", err)
|
||||
os.Exit(1)
|
||||
}
|
||||
defer rabbitConn.Close()
|
||||
|
||||
rabbitCh, err := rabbitConn.Channel()
|
||||
if err != nil {
|
||||
log.Error("failed to open RabbitMQ channel", "err", err)
|
||||
os.Exit(1)
|
||||
}
|
||||
defer rabbitCh.Close()
|
||||
|
||||
// Создаём MQTT клиент
|
||||
mqttClient, err := connectMQTT(cfg, log)
|
||||
if err != nil {
|
||||
log.Error("failed to connect to MQTT broker", "err", err)
|
||||
os.Exit(1)
|
||||
}
|
||||
defer mqttClient.Disconnect(500)
|
||||
|
||||
// Функция-обработчик MQTT сообщений
|
||||
// Вызывается в goroutine paho при каждом сообщении
|
||||
messageHandler := buildMQTTMessageHandler(rabbitCh, log)
|
||||
|
||||
// Подписываемся на все telemetry топики всех namespace
|
||||
// "+/telemetry/+" = {любой namespace}/telemetry/{любой deviceId}
|
||||
const telemetryTopicFilter = "+/telemetry/+"
|
||||
token := mqttClient.Subscribe(telemetryTopicFilter, 1, messageHandler)
|
||||
token.Wait()
|
||||
if token.Error() != nil {
|
||||
log.Error("mqtt subscribe failed", "topic", telemetryTopicFilter, "err", token.Error())
|
||||
os.Exit(1)
|
||||
}
|
||||
log.Info("subscribed to MQTT topic", "filter", telemetryTopicFilter)
|
||||
|
||||
<-ctx.Done()
|
||||
log.Info("shutting down iot-mqtt-bridge")
|
||||
}
|
||||
|
||||
// loadBridgeConfig читает конфигурацию из env vars.
|
||||
// Завершает процесс если обязательные переменные отсутствуют.
|
||||
func loadBridgeConfig() mqttBridgeConfig {
|
||||
required := func(key string) string {
|
||||
v := os.Getenv(key)
|
||||
if v == "" {
|
||||
slog.Error("required env var not set", "key", key)
|
||||
os.Exit(1)
|
||||
}
|
||||
return v
|
||||
}
|
||||
|
||||
return mqttBridgeConfig{
|
||||
MQTTBrokerURL: getEnvOrDefault("MQTT_BROKER_URL", "tcp://emqx.sless.svc:1883"),
|
||||
MQTTUsername: required("MQTT_USERNAME"),
|
||||
MQTTPassword: required("MQTT_PASSWORD"),
|
||||
RabbitMQURL: required("RABBITMQ_URL"),
|
||||
}
|
||||
}
|
||||
|
||||
func getEnvOrDefault(key, defaultVal string) string {
|
||||
if v := os.Getenv(key); v != "" {
|
||||
return v
|
||||
}
|
||||
return defaultVal
|
||||
}
|
||||
|
||||
// connectMQTT устанавливает подключение к EMQX брокеру.
|
||||
// AutoReconnect=true — paho сам переподключается при разрыве.
|
||||
func connectMQTT(cfg mqttBridgeConfig, log *slog.Logger) (mqtt.Client, error) {
|
||||
opts := mqtt.NewClientOptions()
|
||||
opts.AddBroker(cfg.MQTTBrokerURL)
|
||||
opts.SetClientID("sless-iot-bridge")
|
||||
opts.SetUsername(cfg.MQTTUsername)
|
||||
opts.SetPassword(cfg.MQTTPassword)
|
||||
opts.SetAutoReconnect(true)
|
||||
opts.SetConnectRetry(true)
|
||||
opts.SetConnectRetryInterval(5 * time.Second)
|
||||
opts.SetKeepAlive(30 * time.Second)
|
||||
opts.SetCleanSession(false) // сохраняем подписки при реконнекте
|
||||
|
||||
opts.SetConnectionLostHandler(func(_ mqtt.Client, err error) {
|
||||
log.Warn("MQTT connection lost, reconnecting...", "err", err)
|
||||
})
|
||||
opts.SetReconnectingHandler(func(_ mqtt.Client, _ *mqtt.ClientOptions) {
|
||||
log.Info("MQTT reconnecting...")
|
||||
})
|
||||
opts.SetOnConnectHandler(func(_ mqtt.Client) {
|
||||
log.Info("MQTT connected to broker")
|
||||
})
|
||||
|
||||
client := mqtt.NewClient(opts)
|
||||
token := client.Connect()
|
||||
// Ждём максимум 30 секунд
|
||||
if !token.WaitTimeout(30 * time.Second) {
|
||||
return nil, fmt.Errorf("MQTT connect timeout")
|
||||
}
|
||||
if token.Error() != nil {
|
||||
return nil, fmt.Errorf("MQTT connect: %w", token.Error())
|
||||
}
|
||||
return client, nil
|
||||
}
|
||||
|
||||
// connectRabbitMQWithRetry подключается к RabbitMQ с повторными попытками.
|
||||
// Retry нужен потому что RabbitMQ может стартовать позже bridge сервиса.
|
||||
func connectRabbitMQWithRetry(ctx context.Context, url string, log *slog.Logger) (*amqp.Connection, error) {
|
||||
const maxAttempts = 10
|
||||
for attempt := 1; attempt <= maxAttempts; attempt++ {
|
||||
conn, err := amqp.Dial(url)
|
||||
if err == nil {
|
||||
log.Info("connected to RabbitMQ", "attempt", attempt)
|
||||
return conn, nil
|
||||
}
|
||||
log.Warn("RabbitMQ connection failed, retrying...", "attempt", attempt, "err", err)
|
||||
select {
|
||||
case <-ctx.Done():
|
||||
return nil, ctx.Err()
|
||||
case <-time.After(5 * time.Second):
|
||||
}
|
||||
}
|
||||
return nil, fmt.Errorf("exhausted %d RabbitMQ connection attempts", maxAttempts)
|
||||
}
|
||||
|
||||
// buildMQTTMessageHandler возвращает функцию-обработчик MQTT сообщений.
|
||||
// Замыкание над rabbitCh (RabbitMQ channel) и logger.
|
||||
func buildMQTTMessageHandler(rabbitCh *amqp.Channel, log *slog.Logger) mqtt.MessageHandler {
|
||||
return func(_ mqtt.Client, msg mqtt.Message) {
|
||||
topic := msg.Topic()
|
||||
payload := msg.Payload()
|
||||
|
||||
// Топик: "{namespace}/telemetry/{deviceId}"
|
||||
// Извлекаем namespace (первый сегмент) и deviceId (третий сегмент)
|
||||
parts := strings.SplitN(topic, "/", 3)
|
||||
if len(parts) != 3 {
|
||||
log.Warn("unexpected MQTT topic format, skipping", "topic", topic)
|
||||
return
|
||||
}
|
||||
ns := parts[0]
|
||||
deviceID := parts[2]
|
||||
|
||||
// Формируем envelope — оборачиваем payload в JSON с метаданными
|
||||
// Payload от устройства может быть любым JSON или строкой
|
||||
rawPayload := json.RawMessage(payload)
|
||||
if !json.Valid(payload) {
|
||||
// Если payload не JSON — упаковываем в строку
|
||||
quotedBytes, _ := json.Marshal(string(payload))
|
||||
rawPayload = json.RawMessage(quotedBytes)
|
||||
}
|
||||
|
||||
envelope := iotTelemetryMessage{
|
||||
Namespace: ns,
|
||||
DeviceID: deviceID,
|
||||
Topic: topic,
|
||||
Payload: rawPayload,
|
||||
ReceivedAt: time.Now().UTC().Format(time.RFC3339),
|
||||
}
|
||||
|
||||
body, err := json.Marshal(envelope)
|
||||
if err != nil {
|
||||
log.Error("marshal telemetry message", "topic", topic, "err", err)
|
||||
return
|
||||
}
|
||||
|
||||
// Queue name: "iot.{namespace}.telemetry"
|
||||
// Declare-on-publish: если queue не существует — создаём
|
||||
queueName := fmt.Sprintf("iot.%s.telemetry", ns)
|
||||
if _, err := rabbitCh.QueueDeclare(queueName, true, false, false, false, nil); err != nil {
|
||||
log.Error("declare RabbitMQ queue", "queue", queueName, "err", err)
|
||||
return
|
||||
}
|
||||
|
||||
err = rabbitCh.Publish(
|
||||
"", // exchange — default exchange
|
||||
queueName, // routing key = queue name для default exchange
|
||||
false, // mandatory
|
||||
false, // immediate
|
||||
amqp.Publishing{
|
||||
ContentType: "application/json",
|
||||
Body: body,
|
||||
DeliveryMode: amqp.Persistent, // сохранять при рестарте RabbitMQ
|
||||
},
|
||||
)
|
||||
if err != nil {
|
||||
log.Error("publish to RabbitMQ", "queue", queueName, "err", err)
|
||||
return
|
||||
}
|
||||
|
||||
log.Info("forwarded IoT telemetry", "topic", topic, "namespace", ns, "device", deviceID, "queue", queueName)
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user