ubnt/unms-crm

UNMS CRM模块Docker镜像文档

镜像概述

本镜像为UNMS（统一网络管理系统/统一管理系统）的CRM（客户关系管理）模块提供Docker化部署方案，旨在简化UNMS CRM功能的部署流程，降低环境依赖复杂度，支持快速集成至UNMS整体系统架构中，提供客户关系管理相关服务。

核心功能与特性

• 客户数据管理：支持客户基本信息（名称、联系方式、所属组织等）的存储、查询、更新与删除，提供结构化客户数据管理能力。
• 交互记录跟踪：记录与客户的关键交互（如服务请求、沟通记录、业务变更等），形成可追溯的交互历史。
• UNMS系统集成：与UNMS其他核心模块（如工单管理、设备管理等）无缝对接，支持数据互通与业务流程联动。
• 轻量级部署：基于Docker容器化设计，简化环境配置，减少对宿主机系统的依赖，支持跨环境一致部署。

使用场景与适用范围

• UNMS系统部署环境：需在UNMS架构中启用CRM功能的企业或服务提供商，用于客户信息与业务交互的集中管理。
• IT服务管理场景：为提供网络设备、服务托管的企业IT部门，提供客户与服务关联的管理能力。
• 服务提供商运营：适用于需要跟踪客户服务状态、历史交互的网络服务提供商，辅助客户关系维护与服务优化。

使用方法与配置说明

前置条件

• 已安装Docker Engine（20.10+版本）或Docker Desktop。
• 已部署UNMS核心系统（若需模块间集成）。
• （可选）若需持久化数据，建议准备外部存储卷或数据库服务。

快速启动（docker run）

通过以下命令快速启动UNMS CRM模块容器：

bash
docker run -d \
  --name unms-crm \
  -p 8080:8080 \  # 映射容器内服务端口至宿主机（默认8080）
  -v /path/to/crm-data:/app/data \  # 挂载数据卷以持久化客户数据
  -e DB_HOST=unms-db \  # 数据库主机地址（若使用外部数据库）
  -e DB_PORT=5432 \  # 数据库端口
  -e DB_USER=crm_user \  # 数据库访问用户
  -e DB_PASSWORD=secure_password \  # 数据库访问密码
  -e UNMS_CORE_URL=http://unms-core:8081 \  # UNMS核心系统地址（用于集成）
  unms-crm:latest

环境变量配置

容器支持通过环境变量调整运行参数，常用配置如下：

Docker Compose配置示例

通过docker-compose.yml实现多容器协同部署（含UNMS核心与CRM模块）：

yaml
version: '3.8'
services:
  unms-core:
    image: unms-core:latest
    ports:
      - "8081:8081"
    # 其他UNMS核心配置...

  unms-crm:
    image: unms-crm:latest
    depends_on:
      - unms-core
    ports:
      - "8080:8080"
    volumes:
      - crm-data:/app/data
    environment:
      - DB_HOST=unms-db
      - DB_PORT=5432
      - DB_USER=crm_user
      - DB_PASSWORD=secure_password
      - UNMS_CORE_URL=http://unms-core:8081
    restart: unless-stopped

  unms-db:  # 示例外部数据库（若使用独立数据库）
    image: postgres:14
    environment:
      - POSTGRES_USER=crm_user
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=unms_crm
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  crm-data:
  db-data:

数据持久化

为避免容器重启导致客户数据丢失，建议通过以下方式持久化数据：

1. 数据卷挂载：如上述示例中，通过-v /path/to/crm-data:/app/data将容器内数据目录挂载至宿主机或命名卷。
2. 外部数据库：将客户数据存储至独立的数据库服务（如PostgreSQL、MySQL），通过环境变量配置数据库连接信息，实现数据持久化与多实例共享。

注意事项

• 模块集成：若需与UNMS核心系统联动，需确保UNMS_CORE_URL配置正确且网络互通。
• 安全配置：生产环境中需通过环境变量或配置文件设置强密码，避免使用默认凭证。
• 版本兼容性：建议使用与UNMS核心系统版本匹配的CRM模块镜像，具体版本对应关系可参考UNMS官方文档。