mendersoftware/useradm

Mender用户管理服务镜像

镜像概述

该镜像为Mender.io设备管理平台的用户管理核心服务，负责处理Mender平台的用户账户全生命周期管理，包括用户创建、查询、更新、删除及权限控制，是Mender生态中用户认证与授权的基础组件。

核心功能与特性

• 用户全生命周期管理：支持用户账户的创建（Create）、查询（Read）、更新（Update）、删除（Delete）操作
• 权限控制：提供基于角色的权限管理，支持为用户分配不同角色（如管理员、普通用户）及权限策略
• 与Mender生态集成：无缝对接Mender其他核心服务（如设备管理、部署服务），确保用户操作在整个平台中的一致性
• REST API支持：提供标准RESTful API接口，支持外部系统集成及自动化用户管理操作
• 数据持久化：支持与数据库（如PostgreSQL）集成，实现用户数据的持久化存储

使用场景

适用于基于Mender.io构建的设备管理平台，用于：

• 管理员创建和管理平台用户账户
• 为不同用户分配设备管理、部署操作等特定权限
• 集成第三方身份系统（通过API）实现用户同步
• 监控和审计用户操作记录

使用方法与配置说明

基本部署命令

通过Docker运行该服务的基本命令如下：

bash
docker run -d \
  --name mender-useradm \
  -p 8080:8080 \
  -e DB_HOST=<数据库主机地址> \
  -e DB_PORT=<数据库端口> \
  -e DB_USER=<数据库用户名> \
  -e DB_PASSWORD=<数据库密码> \
  -e JWT_SECRET=<JWT签名密钥> \
  mendersoftware/useradm:latest

核心环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  useradm:
    image: mendersoftware/useradm:latest
    container_name: mender-useradm
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=useradm
      - DB_PASSWORD=strong_password
      - DB_NAME=useradm
      - JWT_SECRET=your-secure-jwt-secret-key
      - LOG_LEVEL=info
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:13
    container_name: mender-postgres
    environment:
      - POSTGRES_USER=useradm
      - POSTGRES_PASSWORD=strong_password
      - POSTGRES_DB=useradm
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

服务健康检查

服务启动后，可通过访问http://<服务地址>:8080/health端点检查服务状态，返回{"status":"ok"}表示服务正常运行。