mcmoe/mssqldocker

概述

本镜像基于mcr.microsoft.com/mssql/server官方镜像构建，旨在简化SQL Server容器化部署流程，自动完成新数据库创建及管理员用户配置，降低开发与测试环境的初始化成本。

核心功能

• 自动创建指定名称的数据库
• 配置具有sysadmin权限的自定义用户
• 支持docker-compose快速部署与管理
• 提供本地构建与DockerHub拉取两种使用方式
• 允许基于该镜像扩展自定义数据导入等操作

使用场景

• 开发环境快速搭建SQL Server实例
• 测试环境自动化初始化数据库与用户
• 作为基础镜像构建包含业务数据的定制化SQL Server镜像

配置说明

需设置以下环境变量（在docker-compose.yml中配置）：

• ACCEPT_EULA：必须设为Y以接受SQL Server许可协议
• SA_PASSWORD：SA用户密码（需至少8位，包含大小写字母和数字）
• MSSQL_DB：待创建的目标数据库名称
• MSSQL_USER：待创建的管理员用户名
• MSSQL_PASSWORD：管理员用户密码（需符合复杂度要求）

部署示例

克隆仓库

bash
git clone https://github.com/mcmoe/mssqldocker.git

从DockerHub拉取镜像

最新镜像可通过DockerHub获取：
https://hub.docker.com/r/mcmoe/mssqldocker/

仅需docker-compose.yml文件即可使用：

bash
docker-compose pull mcmoe/mssqldocker

提示：可查看DockerHub标签选择特定版本

本地构建镜像

若需修改镜像内容，执行本地构建：

bash
docker-compose build

启动容器

修改docker-compose.yml中的环境变量后，启动容器：

bash
docker-compose up  # 加-d参数可后台运行

连接容器内SQL Server

通过docker exec使用sqlcmd连接：

bash
docker exec -it mssqldev /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P $SA_PASSWORD

扩展自定义镜像

若需添加数据导入等操作，可继承本镜像：
在自定义Dockerfile中添加：

dockerfile
FROM mcmoe/mssqldocker:latest
# 此处添加自定义操作（如COPY数据文件、执行导入脚本）
CMD /bin/bash ./custom-entrypoint.sh  # 覆盖原有CMD，需确保容器持续运行

文件详细说明

docker-compose.yml

整合端口映射与环境变量配置，简化容器启动命令，无需手动输入复杂的docker run参数。

Dockerfile

定义镜像构建步骤：

1. 基于微软SQL Server 2017-CU24-ubuntu-16.04镜像
2. 创建/usr/config目录并复制项目文件
3. 赋予configure-db.sh可执行权限
4. 设置启动脚本为entrypoint.sh

entrypoint.sh

容器启动时执行：

• 启动SQL Server服务
• 调用configure-db.sh完成数据库初始化
• 尾随和日志以保持容器运行

configure-db.sh

等待SQL Server启动完成后，通过sqlcmd执行setup.sql脚本，创建指定数据库和管理员用户。

setup.sql

包含SQL命令：

• 创建指定名称的数据库
• 创建自定义用户并赋予sysadmin服务器角色权限
• 关联用户与数据库的默认架构

sql
CREATE DATABASE $MSSQL_DB;
GO
USE $MSSQL_DB;
GO
CREATE LOGIN $MSSQL_USER WITH PASSWORD = '$MSSQL_PASSWORD';
GO
CREATE USER $MSSQL_USER FOR LOGIN $MSSQL_USER;
GO
ALTER SERVER ROLE sysadmin ADD MEMBER [$MSSQL_USER];
GO