skyere/greencityuser

ITA-Project GreenCityUser 镜像文档

镜像概述

ITA-Project GreenCityUser镜像是GreenCity项目的核心组件之一，专门用于部署和运行用户管理模块。该镜像封装了用户系统的业务逻辑、数据处理及接口服务，旨在为GreenCity项目提供稳定、高效的用户管理解决方案，支持项目在绿色城市规划与管理场景中的用户相关业务需求。

核心功能与特性

• 用户数据管理：支持用户信息的创建、查询、更新及删除（CRUD）操作，提供结构化数据存储能力。
• 认证与授权：集成用户认证机制，支持基于角色的访问控制（RBAC），确保用户操作权限精准管控。
• 业务逻辑集成：与GreenCity项目其他模块（如设施管理、数据分析模块）通过API接口无缝对接，实现用户相关业务流程联动。
• 轻量化部署：基于优化的基础镜像构建，资源占用低，部署启动速度快，适合容器化环境快速扩缩容。

使用场景与适用范围

• GreenCity项目部署：作为GreenCity项目微服务架构中的用户服务节点，独立部署或与其他模块协同运行。
• 开发测试环境：供开发团队在本地或测试环境快速搭建用户管理服务，验证用户相关功能逻辑。
• 生产环境用户服务：在生产环境中作为用户系统的核心运行载体，支撑项目的用户交互与数据处理需求。

使用方法与配置说明

基本部署命令

通过docker run命令快速启动容器：

bash
docker run -d \
  --name greencity-user \
  -p 8080:8080 \
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_USER=user_service \
  -e DB_PASSWORD=secure_password \
  -e SPRING_PROFILES_ACTIVE=prod \
  itaproject/greencity-user:latest

核心环境变量配置

Docker Compose配置示例

在GreenCity项目整体部署中，可通过docker-compose.yml集成用户服务：

yaml
version: '3.8'
services:
  greencity-user:
    image: itaproject/greencity-user:latest
    container_name: greencity-user
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=greencity-mysql
      - DB_PORT=3306
      - DB_USER=user_service
      - DB_PASSWORD=${DB_PASSWORD}
      - SPRING_PROFILES_ACTIVE=prod
    depends_on:
      - greencity-mysql
    restart: unless-stopped

  greencity-mysql:
    image: mysql:8.0
    container_name: greencity-mysql
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=${DB_ROOT_PASSWORD}
      - MYSQL_DATABASE=greencity_user
      - MYSQL_USER=user_service
      - MYSQL_PASSWORD=${DB_PASSWORD}
    ports:
      - "3306:3306"

volumes:
  mysql-data:

数据持久化说明

用户数据默认存储于外部数据库（通过DB_HOST等参数指定），建议在生产环境中使用独立的数据库服务并配置数据持久化，避免容器重启导致数据丢失。