目录
[建议 1:运行 Docker 容器时最常被忽略的参数](#建议 1:运行 Docker 容器时最常被忽略的参数)
[建议 2:正确设置文件夹映射到 Docker 容器的权限](#建议 2:正确设置文件夹映射到 Docker 容器的权限)
[建议 3:Docker 托管的 SQL Server 安装后检查](#建议 3:Docker 托管的 SQL Server 安装后检查)
[建议 4. 记得启用 SQL Server 代理](#建议 4. 记得启用 SQL Server 代理)

如果您喜欢此文章,请收藏、点赞、评论,谢谢,祝您快乐每一天。
介绍
如今,随着微服务在各大公司中的广泛应用,使用 Windows Server 托管 SQL Server 仍然是黄金标准。然而,在某些场景甚至特定环境中,使用 Docker 引擎以容器化方式部署 SQL Server 仍然至关重要。本文将基于我的实践经验,提供一些实用技巧,重点关注企业级部署中一些常被忽视的方面。本文假设读者已具备 Docker 和 SQL Server 的基本知识。
先决条件
对于 Docker 环境,需要设置一个已安装 Docker 的 Linux 操作系统(迷你安装或服务器安装)。这里我将以安装了 Docker 28.2.2 的 Ubuntu 24.04.1 LTS 为例进行说明。如果读者没有在 Ubuntu 上安装 Docker 的经验,我建议使用以下脚本:
apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o docker.gpg
gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg docker.gpg
echo "deb arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
apt update
apt install -y docker-ce docker-ce-cli containerd.io
systemctl restart docker
systemctl enable docker
systemctl status docker
硬件要求至少为 2GB 内存和 2GB 磁盘空间,可根据需要增加 CPU 核心数、内存大小和磁盘空间。
建议 1:运行 Docker 容器时最常被忽略的参数
如微软文章中所述,使用以下命令运行 docker 容器来托管 SQL Server 实例。
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" -p 1433:1433 --name sql1 --hostname sql1 -d mcr.microsoft.com/mssql/server:2025-latest
然而,最常被忽略的参数是"--restart=unless-stopped"。如果没有这个参数,容器将不会在 Docker 主机服务器重启后自动启动。
想象一下如何配置 Docker 服务器,以便在因故障重启后,Docker 服务能够自动启动。然而,容器本身并不会自动启动,这意味着它无法从故障中自动恢复。这种情况非常糟糕,就像 SQL Server 服务没有设置为自动启动一样。但有一种例外情况:当容器由管理员手动关闭时,它不会自动启动,因此我们需要运行如下命令:
docker run --restart=unless-stopped -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=123123Ppl@' -p 1433:1433 -d mcr.microsoft.com/mssql/server:2022-latest
建议 2:正确设置文件夹映射到 Docker 容器的权限
还有一件重要的事情,我们必须设置文件夹映射或 Docker 卷,用于持久化 SQL Server 数据和配置存储,有两种方法可以实现这一目标:
第一种方法是使用 Docker 卷,具体命令请参考微软文章:
docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/mssql/server:2022-latest
第二种方法是使用文件夹映射将文件夹映射到 Docker 容器,请参考微软的文章:
docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 \
-v <host directory>/data:/var/opt/mssql/data \
-v <host directory>/log:/var/opt/mssql/log \
-v <host directory>/secrets:/var/opt/mssql/secrets \
-d mcr.microsoft.com/mssql/server:2022-latest
在查阅有关第二种解决方案的文章时,我发现大多数文章都缺少如何为需要映射到容器的文件夹设置最小权限的方法。
在这种情况下,我使用以下命令创建了三个映射到 Docker 容器的文件夹:
mkdir /mssql
mkdir /mssql/data /mssql/log /mssql/secrets
如果 Docker 主机服务器上的文件夹没有足够的权限供容器中的用户"mssql"访问,则会收到如下错误:

但是,过多的权限设置可能会导致 Linux 系统中不相关的帐户访问和修改与 SQL Server 相关的文件,因此请使用以下命令设置权限:
chown -R 10001:0 /mssql/data /mssql/log /mssql/secrets
chmod -R 700 /mssql/data /mssql/log /mssql/secrets
"10001"是容器中 mssql 用户的 uid,它也会映射到 docker 主机服务器。
以下 Dockerfile中提到了mssql 的 uid:

然后运行以下命令在 Docker 主机服务器上启动容器:
docker run --restart=unless-stopped -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=SAPassword' -p 1433:1433 -v /mssql/data:/var/opt/mssql/data -v /mssql/log:/var/opt/mssql/log -v /mssql/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/mssql/server:2022-latest
建议 3:Docker 托管的 SQL Server 安装后检查
我们必须检查 SQL Server 安装是否成功。请注意,即使 Docker 容器正在运行,也不代表 SQL Server 已顺利安装。请检查容器日志以查看安装进度。使用以下命令检查 SQL Server 安装进度:
docker logs -f 'container name'
一旦得到以下输出,就表示安装成功:

检查以下文件夹下的文件(Docker 主机上映射到容器的文件夹):/mssql/log、/mssql/data 和 /mssql/secrets。
如果看到以下输出,则表示安装成功。请使用"ls -l"或"ll"命令列出文件夹下的文件:
在 /mssql/data 文件夹下:

在 /mssql/log 文件夹下

在 /mssql/secrets 文件夹下

在容器中测试 SQL Server 连接,并运行如下 SQL 查询。使用以下命令进入 Docker 容器:
docker exec -it -u root 26 a7ebc7f712 / bin / bash

然后使用 sqlcmd 连接到 SQL 服务器并运行 SQL 查询。如果看到以下信息,则表示安装成功:

请在上述命令中添加参数"-C":
/opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P 'SAPassword' -C -Q "SELECT @@VERSION"
例如,如果您运行命令时不带"-C"参数:
/opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P 'SAPassword'
由于 SQL Server 使用的是自签名证书,因此会出现此错误:

最后,请使用以下命令检查 Docker 容器的 CPU 使用率和内存使用情况:
docker stats
输出结果为:

建议 4. 记得启用 SQL Server 代理
SQL Server 代理对于运行作业至关重要,但默认情况下它并未启用。首次在完成所有 SQL Server 设置后使用 SSMS 连接到 SQL Server 时,您会发现 SQL Server 代理处于禁用状态:


然后进入 Docker 容器以启用 SQL Server 代理:

请记住,无法在容器内部运行"systemctl restart mssql-server.service",因此只需像这样重启目标容器即可:

容器重新启动后,再次通过 SSMS 连接到 SQL Server 实例,可以看到 SQL Server 代理已经启用:

其他建议
- 请更改 SQL Server 的容器暴露端口,例如使用"-p 14133:1433"替换"-p 1433:1433"。
- 如果我们在同一个 Docker 主机上使用多个容器来托管 SQL Server 实例,那么必须为每个容器设置 CPU 核心数和内存限制。
概括
本文分享了一些关于如何在生产环境中使用 Docker 托管 SQL Server 的实用建议。尤其对于初次使用 Docker 的 SQL Server DBA 来说,这些建议可以帮助他们避免一些常见问题。这些问题虽然容易被忽视,微软的官方技术文档中也没有明确提及,但它们符合最佳实践,而且至关重要。本文涵盖的最佳实践相对有限,欢迎读者提出建议和指正。
参考
使用 Docker 运行 SQL Server Linux 容器镜像:https://learn.microsoft.com/en-us/sql/linux/quickstart-install-connect-docker ?view=sql-server-ver17&tabs=cli&pivots=cs1-bash
配置和自定义 SQL Server Linux 容器:https://learn.microsoft.com/en-us/sql/linux/sql-server-linux-docker-container-configure?view =sql-server-ver17&pivots=cs1-bash#persist
在 Linux 容器中还原 SQL Server 数据库:https://learn.microsoft.com/en-us/sql/linux/tutorial-restore-backup-in-sql-server-container?view =sql-server-ver17&tabs=cli
排查 SQL Server Docker 容器故障:https://learn.microsoft.com/en-us/sql/linux/sql-server-linux-docker-container-troubleshooting ?view=sql-server-ver17&pivots=cs1-bash
如果您喜欢此文章,请收藏、点赞、评论,谢谢,祝您快乐每一天。