如何构建可在多版本Windows（支持Docker）运行的.NET Core服务镜像

核心原因 #

Windows容器镜像存在严格的OS版本兼容性限制：镜像的基础OS版本不能高于宿主机的OS版本。你用Windows 2022代理构建时，mcr.microsoft.com/dotnet/runtime:6.0默认会拉取对应Windows Server 2022版本的基础镜像，导致低版本Windows宿主机（如2019、2016等）无法运行；而Windows 2019代理构建的镜像基于Windows Server 2019，能向下兼容部分低版本系统，但要覆盖更多版本还需调整。

另外注意：.NET 6官方不再支持Windows Server 2008 R2及更早版本，若必须支持该版本，需额外处理（见下文）。

解决方案 #

1. 更换兼容的基础镜像标签 #

修改Dockerfile中的FROM语句，指定基于Windows Server Core LTSC 2019的.NET镜像，这类镜像可兼容Windows Server 2012 R2、2016、2019、2022：

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

#Depending on the operating system of the host machines(s) that will build or run the containers, the image specified in the FROM statement may need to be changed.
#For more information, please see https://aka.ms/containercompat

# 使用LTSC2019版本的基础镜像，兼容多版本Windows Server
FROM mcr.microsoft.com/dotnet/runtime:6.0-windowsservercore-ltsc2019 AS base

WORKDIR /app

# 构建阶段同样使用对应版本的SDK镜像
FROM mcr.microsoft.com/dotnet/sdk:6.0-windowsservercore-ltsc2019 AS build

WORKDIR /src
COPY ["WebSocketClientService/WebSocketClientService.csproj", "WebSocketClientService/"]
COPY ["S3DocumentSyncLib/S3DocumentSyncLib.csproj", "S3DocumentSyncLib/"]
COPY ["CommonChat/WSDataModel.csproj", "CommonChat/"]
COPY ["WebSocketClient/WebSocketClient.csproj", "WebSocketClient/"]
COPY ["websocket-sharp-core/websocket-sharp-core.csproj", "websocket-sharp-core/"]
RUN dotnet restore "WebSocketClientService/WebSocketClientService.csproj"
COPY . .
WORKDIR "/src/WebSocketClientService"
RUN dotnet build "WebSocketClientService.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebSocketClientService.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebSocketClientService.dll"]

2. 固定Azure DevOps构建代理版本 #

始终使用Windows 2019代理进行构建：

• 在Pipeline的pool配置中指定：

  pool:
    vmImage: 'windows-2019'
  

  避免使用Windows 2022代理，防止构建出高版本OS的镜像。

3. Windows Server 2008兼容处理（可选） #

由于.NET 6不支持Windows Server 2008 R2及更早版本，若必须支持该版本，需：

• 将项目迁移至**.NET Framework 4.8**（长期支持版本），并使用对应的Windows Server Core 2008 R2基础镜像（注意：该镜像已停止官方维护，存在安全风险）。
• 或降级至**.NET Core 3.1**（已终止官方支持，仅临时应急方案），使用mcr.microsoft.com/dotnet/runtime:3.1-windowsservercore-ltsc2019镜像，但仍需确认宿主机是否能运行该容器。

验证步骤 #

1. 用修改后的Dockerfile在Windows 2019代理上构建镜像并推送至Docker Hub。
2. 在目标Windows Server版本上拉取镜像，运行容器验证兼容性。

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