feat: перенос IoT managed service из sless в отдельную репу
Компоненты: - iot-operator: controller-manager (IoTDevice CRD) + REST API (порт 9090) - mqtt-bridge: MQTT (EMQX) → Kafka bridge - kafka-consumer: Kafka → Postgres pipeline Модуль: gitea.services.ngcloud.ru/Nail/IoT Все 3 бинарника собираются, import paths адаптированы.
This commit is contained in:
Naeel
@@ -0,0 +1,83 @@
|
||||
# IoT MVP — E2E Demo
|
||||
|
||||
## Что делает этот пример
|
||||
|
||||
Показывает полную цепочку:
|
||||
|
||||
```
|
||||
IoT Device (mosquitto_pub)
|
||||
→ MQTT PUBLISH → EMQX (HTTP auth → sless-operator)
|
||||
→ [iot-mqtt-bridge подписан на "+/telemetry/+"]
|
||||
→ RabbitMQ queue "iot.{namespace}.telemetry"
|
||||
→ event-dispatcher
|
||||
→ POST → serverless function (handler.py)
|
||||
```
|
||||
|
||||
## Предусловия
|
||||
|
||||
1. EMQX запущен: `kubectl apply -f deployments/k8s/emqx.yaml`
|
||||
2. iot-mqtt-bridge запущен: `kubectl apply -f deployments/k8s/iot-mqtt-bridge.yaml`
|
||||
3. event-dispatcher запущен (уже должен работать)
|
||||
|
||||
## Запуск
|
||||
|
||||
```bash
|
||||
# Установить переменные
|
||||
export API_TOKEN="your-jwt-token"
|
||||
export NAMESPACE="sless-abc123def456" # твой namespace
|
||||
|
||||
# Инициализировать
|
||||
terraform init
|
||||
terraform apply \
|
||||
-var="namespace=${NAMESPACE}" \
|
||||
-var="api_token=${API_TOKEN}"
|
||||
|
||||
# Получить credentials
|
||||
MQTT_USER=$(terraform output -raw mqtt_username)
|
||||
MQTT_PASS=$(terraform output -raw mqtt_password)
|
||||
MQTT_TOPIC=$(terraform output -raw mqtt_topic)
|
||||
|
||||
echo "MQTT user: ${MQTT_USER}"
|
||||
echo "MQTT topic: ${MQTT_TOPIC}"
|
||||
```
|
||||
|
||||
## Отправить тестовое сообщение
|
||||
|
||||
```bash
|
||||
# Через mosquitto_pub (из пода внутри кластера)
|
||||
kubectl run mqtt-test --rm -i --image=eclipse-mosquitto --restart=Never -- \
|
||||
mosquitto_pub \
|
||||
-h emqx.sless.svc \
|
||||
-p 1883 \
|
||||
-u "${MQTT_USER}" \
|
||||
-P "${MQTT_PASS}" \
|
||||
-t "${MQTT_TOPIC}" \
|
||||
-m '{"temperature": 22.5, "humidity": 65, "unit": "celsius"}'
|
||||
```
|
||||
|
||||
## Проверить что функция вызвалась
|
||||
|
||||
```bash
|
||||
# Логи event-dispatcher
|
||||
kubectl logs -n sless deployment/event-dispatcher -f
|
||||
|
||||
# Логи функции (через invocations API)
|
||||
curl -H "Authorization: Bearer ${API_TOKEN}" \
|
||||
https://sless.kube5s.ru/v1/namespaces/${NAMESPACE}/functions/iot-telemetry-handler/invocations
|
||||
```
|
||||
|
||||
## Структура файлов
|
||||
|
||||
```
|
||||
examples/IOT/
|
||||
main.tf # Terraform: function + trigger + iot_device
|
||||
handler.py # Python обработчик телеметрии
|
||||
README.md # Этот файл
|
||||
```
|
||||
|
||||
## Известные ограничения MVP
|
||||
|
||||
- `sless_iot_device` Terraform ресурс требует реализации в terraform-provider-sless (Этап 6)
|
||||
- EMQX TLS отключён — включить для prod (настроить cert-manager secret)
|
||||
- iot-mqtt-bridge credentials создаются вручную (автоматизировать в будущем)
|
||||
- Нет обратного канала: Cloud → Device команды (Device Shadow — вне MVP)
|
||||
@@ -0,0 +1,57 @@
|
||||
"""
|
||||
Создано: 2026-04-04
|
||||
handler.py — обработчик IoT-телеметрии для демонстрации IoT MVP.
|
||||
|
||||
Вызывается event-dispatcher при каждом MQTT сообщении от устройства.
|
||||
Входящий event.body содержит JSON сформированный mqtt-bridge:
|
||||
{
|
||||
"namespace": "sless-abc123",
|
||||
"device_id": "temp-sensor-01",
|
||||
"topic": "sless-abc123/telemetry/temp-sensor-01",
|
||||
"payload": {"temperature": 22.5, "humidity": 65},
|
||||
"received_at": "2026-04-04T12:00:00Z"
|
||||
}
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
|
||||
|
||||
def handle(event, context):
|
||||
"""Обработчик телеметрии IoT-устройства.
|
||||
|
||||
Логирует данные и возвращает подтверждение.
|
||||
В реальном сценарии здесь: сохранение в БД, алертинг, управляющие команды.
|
||||
"""
|
||||
log_level = os.getenv("LOG_LEVEL", "INFO")
|
||||
|
||||
try:
|
||||
body = json.loads(event.get("body", "{}"))
|
||||
except json.JSONDecodeError as e:
|
||||
return {
|
||||
"statusCode": 400,
|
||||
"body": json.dumps({"error": f"invalid JSON: {e}"})
|
||||
}
|
||||
|
||||
namespace = body.get("namespace", "unknown")
|
||||
device_id = body.get("device_id", "unknown")
|
||||
payload = body.get("payload", {})
|
||||
received_at = body.get("received_at", "")
|
||||
|
||||
if log_level == "INFO":
|
||||
print(f"[IoT] namespace={namespace} device={device_id} at={received_at}")
|
||||
print(f"[IoT] payload={json.dumps(payload)}")
|
||||
|
||||
# Здесь добавить бизнес-логику:
|
||||
# - Запись в PostgreSQL (через POSTGRES_DSN из env)
|
||||
# - Проверка порогов и алертинг
|
||||
# - Публикация управляющей команды обратно на устройство
|
||||
|
||||
return {
|
||||
"statusCode": 200,
|
||||
"body": json.dumps({
|
||||
"processed": True,
|
||||
"device_id": device_id,
|
||||
"namespace": namespace,
|
||||
})
|
||||
}
|
||||
@@ -0,0 +1,102 @@
|
||||
# Создано: 2026-04-04
|
||||
# E2E Demo: IoT Device → MQTT → RabbitMQ → Serverless Function
|
||||
#
|
||||
# Порядок применения:
|
||||
# 1. terraform init
|
||||
# 2. terraform apply
|
||||
# 3. Получить credentials: terraform output mqtt_password
|
||||
# 4. Отправить тестовое MQTT сообщение (см. README.md ниже)
|
||||
|
||||
terraform {
|
||||
required_providers {
|
||||
sless = {
|
||||
source = "kube5s.ru/naeel/sless"
|
||||
version = ">= 0.1"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Адрес API sless оператора
|
||||
provider "sless" {
|
||||
api_url = "https://sless.kube5s.ru"
|
||||
}
|
||||
|
||||
# Переменные
|
||||
variable "namespace" {
|
||||
description = "Namespace пользователя (создаётся через EnsureNamespace)"
|
||||
type = string
|
||||
}
|
||||
|
||||
variable "api_token" {
|
||||
description = "JWT токен для аутентификации в sless API"
|
||||
type = string
|
||||
sensitive = true
|
||||
}
|
||||
|
||||
# Python функция-обработчик IoT-телеметрии
|
||||
resource "sless_function" "iot_telemetry_handler" {
|
||||
namespace = var.namespace
|
||||
name = "iot-telemetry-handler"
|
||||
runtime = "python3.11"
|
||||
entrypoint = "handler.handle"
|
||||
memory_mb = 128
|
||||
timeout_sec = 30
|
||||
|
||||
env_vars = {
|
||||
LOG_LEVEL = "INFO"
|
||||
}
|
||||
}
|
||||
|
||||
# Event Trigger: подписка на IoT telemetry queue
|
||||
# event-dispatcher читает из этой очереди и вызывает функцию
|
||||
resource "sless_trigger" "iot_telemetry_trigger" {
|
||||
namespace = var.namespace
|
||||
name = "iot-telemetry-events"
|
||||
type = "event"
|
||||
function_ref = sless_function.iot_telemetry_handler.name
|
||||
# queue = "iot.{namespace}.telemetry" — формируется mqtt-bridge автоматически
|
||||
queue = "iot.${var.namespace}.telemetry"
|
||||
enabled = true
|
||||
}
|
||||
|
||||
# IoT устройство — температурный датчик
|
||||
resource "sless_iot_device" "temperature_sensor" {
|
||||
namespace = var.namespace
|
||||
name = "temperature-sensor"
|
||||
device_id = "temp-sensor-01"
|
||||
enabled = true
|
||||
|
||||
metadata = {
|
||||
model = "DHT22"
|
||||
location = "server-room"
|
||||
owner = "ops-team"
|
||||
}
|
||||
}
|
||||
|
||||
# ——— Outputs ———
|
||||
|
||||
output "mqtt_broker" {
|
||||
value = "emqx.sless.svc:1883"
|
||||
description = "MQTT broker адрес (доступен внутри кластера)"
|
||||
}
|
||||
|
||||
output "mqtt_username" {
|
||||
value = sless_iot_device.temperature_sensor.mqtt_username
|
||||
description = "MQTT username для устройства"
|
||||
}
|
||||
|
||||
output "mqtt_password" {
|
||||
value = sless_iot_device.temperature_sensor.mqtt_password
|
||||
sensitive = true
|
||||
description = "MQTT пароль для устройства (sensitive)"
|
||||
}
|
||||
|
||||
output "mqtt_topic" {
|
||||
value = "${var.namespace}/telemetry/temp-sensor-01"
|
||||
description = "MQTT topic для публикации телеметрии"
|
||||
}
|
||||
|
||||
output "iot_device_phase" {
|
||||
value = sless_iot_device.temperature_sensor.phase
|
||||
description = "Статус IoT устройства (Active/Pending/Disabled/Error)"
|
||||
}
|
||||
Reference in New Issue
Block a user