mendersoftware/deviceconfig

Mender deviceconfig 微服务镜像

镜像概述和主要用途

Mender deviceconfig微服务镜像是Mender开源设备管理平台的关键组件，专注于设备配置的全生命周期管理。该服务提供配置模板管理、版本控制、设备特定配置定制及配置分发等核心能力，旨在解决大规模物联网设备部署中配置一致性、可追溯性及管理效率问题，是构建企业级设备管理体系的基础组件。

核心功能和特性

配置模板管理

• 支持创建、编辑、删除可复用的配置模板，降低重复配置成本
• 模板支持变量注入，适配不同设备型号或部署场景需求

配置版本控制

• 自动记录配置变更历史，支持版本回溯
• 关联配置版本与设备部署状态，实现配置变更可追溯

设备特定配置

• 支持为单个设备或设备组定义差异化配置
• 配置优先级机制：设备级配置自动覆盖模板默认值

配置分发与验证

• 集成Mender部署流程，支持配置按批次推送
• 内置配置格式验证（JSON/XML/YAML），避免无效配置下发

权限与安全

• 基于RBAC（基于角色的访问控制）的配置操作权限管理
• 配置数据传输加密，确保敏感配置信息安全

使用场景和适用范围

典型应用场景

• 工业物联网设备集群：管理产线中数百台PLC、传感器的运行参数配置
• 智能家居设备批量部署：为不同型号智能家电推送网络配置、功能参数
• 企业级边缘设备管理：统一配置分支机构边缘网关的路由策略、安全规则

适用范围

• 设备数量：100+规模的设备集群
• 设备类型：支持JSON/XML/YAML配置的嵌入式设备、边缘计算设备
• 部署环境：私有云、混合云及边缘计算环境

使用方法和配置说明

Docker 运行示例

基础运行命令

docker
docker run -d \
  --name mender-deviceconfig \
  -p 8080:8080 \
  -e DB_TYPE=postgres \
  -e DB_HOST=postgres-host \
  -e DB_PORT=5432 \
  -e DB_USER=mender \
  -e DB_PASSWORD=secure-pass \
  -e DB_NAME=deviceconfig \
  -e AUTH_SERVICE_URL=http://mender-auth:8080 \
  mendersoftware/deviceconfig:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  deviceconfig:
    image: mendersoftware/deviceconfig:latest
    container_name: mender-deviceconfig
    ports:
      - "8080:8080"
    environment:
      # 数据库配置
      - DB_TYPE=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=mender
      - DB_PASSWORD=secure-pass
      - DB_NAME=deviceconfig
      # 服务配置
      - LISTEN_PORT=8080
      - LOG_LEVEL=info
      - REQUEST_TIMEOUT=30s
      # 依赖服务地址
      - AUTH_SERVICE_URL=http://auth:8080
      - DEVICE_SERVICE_URL=http://device-service:8080
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14-alpine
    container_name: mender-deviceconfig-db
    environment:
      - POSTGRES_USER=mender
      - POSTGRES_PASSWORD=secure-pass
      - POSTGRES_DB=deviceconfig
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

环境变量配置

依赖说明

• 数据库：仅支持PostgreSQL 12+，用于存储配置模板、版本历史及设备配置映射关系
• Mender核心服务：需与Mender auth（认证服务）、device-service（设备服务）配合使用
• 网络：需确保与设备管理平台其他组件及目标设备间网络通畅（默认8080端口）