KubeEdge 边缘应用编排与设备管理（DeviceTwin / Mapper）

一、背景

KubeEdge 的强项是边缘设备管理（IoT）。通过 DeviceModel/DeviceInstance + Mapper，把物理设备（Modbus/MQTT/Bluetooth）抽象为 K8s 资源，云端统一管控。

二、环境信息

• KubeEdge v1.15（含 DeviceController）
• 设备：温湿度传感器（MQTT）
• Mapper：官方/自定义 mapper

三、操作要点

1. 定义设备模型（DeviceModel）

apiVersion: devices.kubeedge.io/v1alpha2
kind: DeviceModel
metadata: { name: sensor-model }
spec:
  properties:
  - name: temperature
    type: { name: int, accessMode: ReadOnly }

2. 创建设备实例（DeviceInstance）

apiVersion: devices.kubeedge.io/v1alpha2
kind: Device
metadata: { name: sensor-1, labels: { node: edge-1 } }
spec:
  deviceModelRef: { name: sensor-model }
  protocol: { mqtt: { address: tcp://127.0.0.1:1883 } }

3. Mapper 连接物理设备

部署对应 mapper（如 mqtt-mapper），负责协议转换，把设备数据写入 DeviceTwin。

4. 边缘应用编排

kubectl apply -f edge-app.yaml --field-selector=...   # 调度到 edge-1

四、验证方式

kubectl get devicemodels
kubectl get devices
kubectl get device edge-1 -o yaml   # status.twins 含实时温度
kubectl logs -n kubeedge <mapper-pod>

五、常见问题

• Mapper 开发复杂：优先用官方 mapper，私有协议需自研
• 设备协议适配：Modbus/MQTT/Bluetooth 各有 mapper，确认地址/寄存器
• Twin 同步延迟：受云边通道质量影响，弱网下延迟升高
• 数据不上报：检查 mapper 连接、DeviceInstance 协议配置、边缘网络