uwthalesians/mssql

Perceptia MSSQL 数据库镜像文档

镜像概述和主要用途

本镜像基于微软SQL Server官方镜像 mcr.microsoft.com/mssql/server 构建，专为Perceptia应用提供数据库服务。它定制了基础镜像的入口点，在启动MSSQL服务器前运行额外的初始化脚本，自动引导Perceptia数据库架构和存储过程。适用于需要快速部署Perceptia应用数据库环境的开发、测试和生产场景。

核心功能和特性

• 基于官方镜像：构建于微软SQL Server官方镜像，确保兼容性和稳定性
• 自动初始化：启动时自动运行数据库架构和存储过程引导脚本
• 环境变量配置：支持通过环境变量自定义数据库设置和初始化行为
• 多环境支持：可配置生产/开发环境，分别对应有限日志和详细日志模式
• 版本化管理：镜像标签与Perceptia数据库存储过程版本关联，便于版本控制

版本指南

主版本 1

主版本1（如 1.0.0）基于MSSQL Server镜像 2017-CU12-ubuntu 构建。镜像版本与Perceptia数据库存储过程版本对应，使用以下环境变量：

• 必填环境变量：

  • SA_PASSWORD=SomePassword：设置MSSQL服务器 sa 用户的密码
  • ACCEPT_EULA=Y：自动接受MSSQL的最终用户许可协议
  • GATEWAY_SP_USERNAME={username}：（版本>0.7）创建网关服务使用的服务主体用户名
  • GATEWAY_SP_PASSWORD={password}：（版本>0.7）设置网关服务主体用户的密码

• 可选环境变量：

  • SKIP_SETUP=Y：若值为 Y，跳过运行 setup-db.sh 脚本（引导数据库架构），其他值视为未设置
  • SKIP_SETUP_IF_EXISTS=Y：若值为 Y 且Perceptia数据库已存在，跳过运行 setup-db.sh 脚本，其他值视为未设置
  • MSSQL_ENVIRONMENT={production|development}：设置服务器运行环境，production（有限日志）或 development（详细日志），默认 development

主版本 0

主版本0（如 0.3.2）基于MSSQL Server镜像 2017-CU12-ubuntu 构建。版本 ≥0.7.1 与Perceptia数据库存储过程版本对应，版本 <0.7.1 与Perceptia数据库架构版本对应，使用以下环境变量：

• 必填环境变量：

  • SA_PASSWORD=SomePassword：设置MSSQL服务器 sa 用户的密码
  • ACCEPT_EULA=Y：自动接受MSSQL的最终用户许可协议

• 可选环境变量：

  • SKIP_SETUP=Y：若值为 Y，跳过运行 setup-db.sh 脚本（引导数据库架构），其他值视为未设置
  • SKIP_SETUP_IF_EXISTS=Y：若值为 Y 且Perceptia数据库已存在，跳过运行 setup-db.sh 脚本，其他值视为未设置

标签指南

版本标签

格式：uwthalesians/mssql:{version}

标签基于Perceptia数据库引导版本，例如 1.0.0 表示包含1.0.0版本的Perceptia数据库存储过程。除完整版本（major.minor.patch）外，还提供major和major.minor形式的标签（部分旧版本可能不支持）。

示例：uwthalesians/mssql:1.0.0、uwthalesians/mssql:1.0、uwthalesians/mssql:1

构建标签

格式：uwthalesians/mssql:{version}-build-{build value}

包含 -build-{build value} 后缀，标识CI构建编号，确保镜像版本固定。build value 为每次CI构建递增的编号，也可使用 latest 表示该版本的最新构建（需与分支标签配合使用）。

示例：uwthalesians/mssql:1.0.0-build-281、uwthalesians/mssql:1.0.0-build-latest-branch-quetzal-auth

分支标签

格式：uwthalesians/mssql:{version}-build-{build value}-branch-{branch name}

包含 -branch-{branch name} 后缀，标识镜像构建来源的代码分支，便于按分支选择镜像。

示例：uwthalesians/mssql:1.0.0-build-281-branch-quetzal-auth

使用方法

拉取镜像

bash
docker pull uwthalesians/mssql:1.0.0-build-latest-branch-develop

运行容器

基本启动命令（开发环境）：

bash
docker run -d \
  --name perceptia-mssql \
  -e SA_PASSWORD=YourStrong!Passw0rd \
  -e ACCEPT_EULA=Y \
  -e GATEWAY_SP_USERNAME=gateway_user \
  -e GATEWAY_SP_PASSWORD=GatewayStrong!Passw0rd \
  -p 1433:1433 \
  uwthalesians/mssql:1.0.0

生产环境配置（有限日志）：

bash
docker run -d \
  --name perceptia-mssql-prod \
  -e SA_PASSWORD=YourStrong!Passw0rd \
  -e ACCEPT_EULA=Y \
  -e GATEWAY_SP_USERNAME=gateway_user \
  -e GATEWAY_SP_PASSWORD=GatewayStrong!Passw0rd \
  -e MSSQL_ENVIRONMENT=production \
  -p 1433:1433 \
  uwthalesians/mssql:1.0.0

跳过初始化（使用已有数据库）：

bash
docker run -d \
  --name perceptia-mssql-existing \
  -e SA_PASSWORD=YourStrong!Passw0rd \
  -e ACCEPT_EULA=Y \
  -e SKIP_SETUP_IF_EXISTS=Y \
  -p 1433:1433 \
  uwthalesians/mssql:1.0.0