h2h-user-service Docker镜像文档

镜像概述

vulcanchayen/h2h-user-service是一个用户服务专用Docker镜像，旨在提供用户管理相关的核心功能。镜像标签遵循[semantic versioning]-[environment]-[git hash commit]格式，其中：

• [semantic versioning]：遵循语义化版本规范（如v1.0.0），用于版本控制
• [environment]：环境标识（如dev、test、prod），用于区分开发、测试和生产环境
• [git hash commit]：Git提交哈希值，用于精确追踪代码版本，确保部署一致性

核心功能与特性

核心功能

• 用户注册与注销
• 用户登录认证与授权
• 用户信息查询与更新
• 用户角色与权限管理

特性

• 版本化标签：通过语义化版本和Git提交哈希实现精确版本追踪
• 环境隔离：支持多环境部署（开发/测试/生产）
• 轻量级设计：优化镜像体积，提升部署效率
• 可配置性：支持通过环境变量调整服务参数

使用场景与适用范围

• H2H系统用户服务组件：作为H2H（可能为特定业务系统缩写）架构中的核心用户服务模块
• 微服务架构：适用于微服务架构中独立部署的用户管理服务
• 多环境部署：满足开发、测试、生产等不同环境的用户服务需求
• 版本可控部署：通过Git提交哈希标签实现代码版本与部署版本的精准对应

使用方法与配置说明

镜像拉取

根据需求选择对应环境和版本的镜像标签，拉取命令示例：

bash
# 拉取生产环境v1.2.0版本，Git提交哈希为a1b2c3d的镜像
docker pull vulcanchayen/h2h-user-service:v1.2.0-prod-a1b2c3d

# 拉取开发环境最新版本（假设语义化版本为v1.3.0，环境为dev）
docker pull vulcanchayen/h2h-user-service:v1.3.0-dev-4e5f6g7h

容器运行

基本运行命令示例：

bash
docker run -d \
  --name h2h-user-service \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \  # 环境配置，需与镜像标签环境一致
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_USER=user_service \
  -e DB_PASSWORD=secure_password \
  vulcanchayen/h2h-user-service:v1.2.0-prod-a1b2c3d

关键配置参数

标签说明

标签结构详解

镜像标签格式：[semantic versioning]-[environment]-[git hash commit]

• 语义化版本（semantic versioning）：遵循MAJOR.MINOR.PATCH格式，如v1.2.0，用于标识功能迭代和兼容性
• 环境标识（environment）：如dev（开发）、test（测试）、prod（生产），确保环境与配置匹配
• Git提交哈希（git hash commit）：代码提交的唯一标识（通常取前7位），如a1b2c3d，用于定位部署代码版本

标签选择建议

• 生产环境：优先选择prod环境标签，配合稳定的语义化版本（如v1.2.0-prod-a1b2c3d）
• 开发测试：使用dev或test环境标签，可选择最新开发版本（如v1.3.0-dev-4e5f6g7h）
• 问题排查：通过Git提交哈希标签可快速定位部署版本对应的代码，便于问题追溯