CircleCI MSSQL测试镜像文档

1. 镜像概述

本镜像为CircleCI官方提供的MSSQL测试环境专用Docker仓库，旨在为CI/CD流程中的MSSQL相关应用提供标准化、可复用的测试环境，确保开发团队在持续集成过程中高效验证数据库应用的兼容性和功能正确性。

2. 核心功能与特性

• 标准化测试环境：提供预配置的MSSQL运行环境，消除本地与CI环境差异导致的测试不一致问题
• CircleCI原生集成：无缝对接CircleCI Pipeline，支持通过.circleci/config.yml直接调用
• 轻量级优化：针对CI场景裁剪非必要组件，减少启动时间和资源占用
• 版本兼容性：支持主流MSSQL版本（如2017、2019等），满足多版本测试需求
• 自动化配置：内置基础数据库初始化脚本，简化测试前置准备步骤

3. 适用场景

• CircleCI CI/CD流程：在自动化构建 pipeline 中执行MSSQL数据库应用的单元测试与集成测试
• 兼容性验证：验证应用在不同MSSQL版本下的运行状态
• 数据库逻辑测试：测试存储过程、触发器、数据迁移脚本等数据库层逻辑
• 多环境一致性保障：确保开发、测试、CI环境中MSSQL配置的统一性

4. 使用方法

4.1 基本使用（CircleCI配置）

在.circleci/config.yml中定义使用本镜像的测试Job：

version: 2.1

jobs:
  test-mssql:
    docker:
      - image: circleci/mssql-test:latest  # 使用本镜像作为执行环境
    steps:
      - checkout  # 拉取代码
      - run:
          name: 启动MSSQL服务
          command: |
            # 启动MSSQL服务（具体命令需根据镜像内置脚本调整）
            /opt/mssql/bin/sqlservr &
            # 等待服务就绪
            sleep 30
      - run:
          name: 执行测试
          command: |
            # 运行应用测试命令（示例）
            dotnet test --connection-string "Server=localhost;User ID=sa;Password=$MSSQL_SA_PASSWORD;Database=testdb"

4.2 环境变量配置

使用时需通过环境变量配置MSSQL实例，常用变量如下：

4.3 本地调试（可选）

如需本地验证镜像功能，可通过docker run命令启动：

docker run -d \
  -e "ACCEPT_EULA=Y" \
  -e "MSSQL_SA_PASSWORD=YourStrong!Passw0rd" \
  -p 1433:1433 \
  --name mssql-test \
  circleci/mssql-test:latest

5. 注意事项

• 本镜像专为CI场景设计，不建议用于生产环境
• 不同MSSQL版本需指定对应镜像标签（如:2017、:2019）
• 高并发测试场景下建议配置CircleCI资源class为medium或更高
• SA密码需满足MSSQL复杂度要求（至少8位，包含大小写字母、数字和特殊字符）

6. 版本信息