hsldevcom/jore4-mssql-testdb

Jore4 MSSQL测试数据库Docker镜像文档

镜像概述和主要用途

本镜像为Jore4项目提供预配置的Microsoft SQL Server测试数据库环境，基于官方MSSQL Server Docker镜像构建，集成了Jore4项目所需的数据库架构及预设测试数据。主要用于简化开发和测试流程，使开发人员和测试工程师能够快速部署包含完整测试数据集的数据库实例，无需手动配置数据库结构和导入测试数据。

核心功能和特性

• 预加载测试数据：内置Jore4项目专用测试数据集，覆盖常见业务场景，满足开发和测试需求
• 简化部署流程：一键启动即可获得可用数据库环境，无需手动执行SQL脚本初始化
• 与Jore4应用兼容：数据库架构和数据结构与Jore4应用程序完全匹配，确保开发测试一致性
• 灵活配置：支持通过环境变量自定义数据库端口、SA密码等关键参数
• 轻量级设计：优化镜像体积，适合本地开发和CI/CD环境使用

使用场景和适用范围

• 本地开发环境：供Jore4项目开发人员在本地搭建一致的数据库环境
• 自动化测试：作为单元测试、集成测试的数据库依赖，提供稳定的测试数据
• CI/CD流水线：在持续集成和持续部署流程中作为测试阶段的数据库服务
• 团队协作：确保团队成员使用相同的测试数据库配置，消除环境差异导致的问题
• 演示环境：快速搭建包含示例数据的演示环境，展示Jore4应用功能

详细使用方法和配置说明

前提条件

• 已安装Docker Engine (20.10+)
• 已安装Docker Compose (可选，用于多容器部署)
• 系统资源满足MSSQL Server要求：至少2GB内存

获取镜像

从Docker Registry拉取（推荐）

如果镜像已发布到Docker Registry，可直接拉取：

bash
docker pull hsldevcom/jore4-mssql-testdb:latest

从源码构建

1. 克隆仓库：

bash
git clone https://github.com/HSLdevcom/jore4-mssql-testdb.git
cd jore4-mssql-testdb

2. 构建镜像：

bash
docker build -t hsldevcom/jore4-mssql-testdb:latest .

运行容器

基本运行命令

bash
docker run -d \
  --name jore4-mssql-testdb \
  -e "ACCEPT_EULA=Y" \
  -e "SA_PASSWORD=YourStrong!Passw0rd" \
  -p 1433:1433 \
  hsldevcom/jore4-mssql-testdb:latest

使用Docker Compose

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  jore4-mssql-testdb:
    image: hsldevcom/jore4-mssql-testdb:latest
    container_name: jore4-mssql-testdb
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=YourStrong!Passw0rd
      - MSSQL_PID=Developer
    ports:
      - "1433:1433"
    volumes:
      - mssql-data:/var/opt/mssql
    restart: unless-stopped

volumes:
  mssql-data:

启动服务：

bash
docker-compose up -d

配置参数说明

连接数据库

容器启动后，可使用任意MSSQL客户端连接数据库：

• 服务器地址：localhost,1433（本地运行时）
• 用户名：sa
• 密码：启动时设置的SA_PASSWORD
• 数据库名称：默认Jore4TestDB（或通过DB_NAME环境变量指定的值）

示例使用sqlcmd连接：

bash
sqlcmd -S localhost,1433 -U sa -P YourStrong!Passw0rd -d Jore4TestDB

注意事项

• 本镜像仅用于开发和测试环境，不建议用于生产环境
• SA密码应设置高强度密码，避免使用简单密码
• 容器首次启动时会初始化数据库，可能需要30-60秒时间，请耐心等待
• 如需持久化数据，建议挂载数据卷（如docker-compose示例所示）
• 镜像基于MSSQL Server，需遵守Microsoft相关许可协议