如何构建含SQL Server与.NET SDK的Docker镜像以运行C#集成测试

方案一：先构建测试项目，再复制到SQL Server容器（推荐） #

这种方式用多阶段构建分离编译和运行环境，既保证容器功能完整，又能减少镜像冗余，提升构建效率。

步骤说明 #

1. 第一阶段：用.NET 7 SDK镜像编译测试项目
   专门用SDK镜像处理代码编译，生成可执行的测试文件，避免在SQL Server容器里安装编译依赖。
2. 第二阶段：基于SQL Server镜像，安装.NET SDK（因为dotnet test命令需要SDK支持），复制编译好的测试文件，最后通过脚本启动SQL Server并执行测试。

完整Dockerfile示例 #

# 第一阶段：构建测试项目
FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
# 先复制项目文件，利用Docker缓存加速构建
COPY ["YourTestProject.csproj", "."]
RUN dotnet restore "./YourTestProject.csproj"
# 复制全部代码
COPY . .
WORKDIR "/src/."
# 编译测试项目，输出到/app/build目录
RUN dotnet build "YourTestProject.csproj" -c Release -o /app/build

# 第二阶段：准备SQL Server运行环境
FROM mcr.microsoft.com/mssql/server:2019-latest AS final
WORKDIR /app

USER root
# 安装.NET SDK 7.0（运行dotnet test必须依赖SDK）
RUN apt-get update && apt-get install -y --no-install-recommends \
    wget \
    ca-certificates \
    && wget -q https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb \
    && dpkg -i packages-microsoft-prod.deb \
    && rm packages-microsoft-prod.deb \
    && apt-get update \
    && apt-get install -y --no-install-recommends \
        dotnet-sdk-7.0 \
    && rm -rf /var/lib/apt/lists/*

# 设置SQL Server必填环境变量
ENV ACCEPT_EULA=Y
ENV SA_PASSWORD=YourStrong@Passw0rd

# 从构建阶段复制编译好的测试文件
COPY --from=build /app/build .

# 复制启动脚本（处理SQL Server启动和测试执行的顺序）
COPY entrypoint.sh .
RUN chmod +x entrypoint.sh

ENTRYPOINT ["./entrypoint.sh"]

配套的entrypoint.sh脚本 #

SQL Server启动需要一定时间，必须等服务就绪后再执行测试，脚本内容如下：

#!/bin/bash

# 后台启动SQL Server
/opt/mssql/bin/sqlservr &

# 等待SQL Server服务就绪（可根据实际情况调整等待时间）
echo "等待SQL Server启动..."
sleep 30s

# 执行集成测试
dotnet test

# 保持容器运行（可选，若测试完成后不需要保留容器可删除此命令）
wait

方案二：直接在SQL Server容器中安装.NET SDK #

如果不想用多阶段构建，也可以直接在SQL Server镜像里安装.NET SDK，修改你原有的Dockerfile即可。

修改后的Dockerfile #

FROM mcr.microsoft.com/mssql/server:2019-latest AS final

WORKDIR /app

USER root
RUN apt-get update && apt-get install -y --no-install-recommends \
       wget \
       ca-certificates \
    \
    # 安装微软包源
    && wget -q https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb \
    && dpkg -i packages-microsoft-prod.deb \
    && rm packages-microsoft-prod.deb \
    \
    # 替换为安装.NET SDK 7.0（原Dockerfile装的是Runtime，无法运行dotnet test）
    && apt-get update \
    && apt-get install -y --no-install-recommends \
        dotnet-sdk-7.0 \
    \
    # 清理缓存减小镜像体积
    && rm -rf /var/lib/apt/lists/*

# 设置SQL Server必填环境变量
ENV ACCEPT_EULA=Y
ENV SA_PASSWORD=YourStrong@Passw0rd

# 复制测试项目代码
COPY . /app

# 复制并设置启动脚本
COPY entrypoint.sh .
RUN chmod +x entrypoint.sh

ENTRYPOINT ["./entrypoint.sh"]

关键修正点 #

• 原Dockerfile中用RUN启动SQL Server的方式无效：RUN只在镜像构建阶段执行，容器启动时不会自动启动SQL服务，必须用ENTRYPOINT或CMD配合脚本处理。
• 必须安装.NET SDK而非Runtime：dotnet test命令依赖SDK的测试工具链，只装Runtime会报错。

方案对比 #

• 方案一（多阶段构建）：镜像构建效率更高，编译层可缓存，代码修改后无需重复安装依赖；最终镜像仅包含必要的运行环境，体积相对可控。
• 方案二（直接安装SDK）：配置更简单，但镜像体积更大，每次代码修改都要在容器内重新编译，效率较低。

内容的提问来源于stack exchange，提问作者PeterDocker