如何配置Azure DevOps中Docker化.NET Core的ASPNETCORE_ENVIRONMENT

现有问题修正 #

当前Dockerfile存在两处硬编码问题，导致运行时无法灵活覆盖环境配置：

• base阶段直接写死ENV ASPNETCORE_ENVIRONMENT Development
• ENTRYPOINT中硬编码--environment=Development，根据.NET Core配置优先级规则，命令行参数优先级高于环境变量，该参数会强制覆盖所有运行时传入的环境变量

.NET Core本身的配置加载逻辑无需修改：只要ASPNETCORE_ENVIRONMENT变量值正确，会自动加载对应后缀的appsettings.{Environment}.json文件，不存在认知偏差。

第一步：修改Dockerfile移除硬编码 #

改动点：

• 保留base阶段的默认ASPNETCORE_ENVIRONMENT值，仅用于本地直接运行容器时的兜底，不会覆盖流水线注入的环境变量
• 删除ENTRYPOINT中硬编码的--environment=Development参数，避免命令行优先级覆盖运行时环境变量

修改后的完整Dockerfile如下：

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS base
WORKDIR /app
EXPOSE 80
# 仅作为本地开发的默认兜底值，部署时会被运行时环境变量覆盖
ENV ASPNETCORE_ENVIRONMENT Development

FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
WORKDIR /src
COPY ["Api/Api.csproj", "Api/"]
RUN dotnet restore "Api/Api.csproj"
COPY . .
WORKDIR "/src/Api"
RUN dotnet build "Api.csproj" -c Release -o /app/build

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

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
# 移除硬编码的环境参数，完全依赖运行时注入的ASPNETCORE_ENVIRONMENT控制
ENTRYPOINT ["dotnet", "Api.dll"]

第二步：确保环境配置文件随镜像打包 #

检查项目中所有appsettings.{Environment}.json的文件属性：

• 右键对应文件 → 属性 → 复制到输出目录 选择「如果较新则复制」
• 确保dotnet publish执行时，这些配置文件会被自动输出到发布目录，随镜像一起打包，避免运行时找不到对应配置文件。

第三步：Azure DevOps流水线配置逻辑 #

遵循云原生最佳实践，镜像本身保持环境无关，所有环境差异配置在运行时注入，同一个镜像可复用于所有部署环境，保障测试、生产环境的镜像一致性，避免构建环节的环境差异。

具体配置分两种常见场景：

场景1：使用Azure容器服务部署（Container Apps/AKS/ACI）

• 在Azure DevOps中为每个部署环境（Development、Production）创建对应的「环境（Environments）」，并给每个环境绑定专属变量组
• 变量组中新增变量ASPNETCORE_ENVIRONMENT，值对应环境名称（开发环境设为Development，生产环境设为Production）
• 流水线的对应部署任务会自动拉取当前部署环境绑定的变量值，注入到容器的环境变量中

场景2：自定义Docker宿主机部署

如果是用自定义docker run脚本部署，只需要在启动命令中通过-e参数注入环境变量即可：

docker run -d -p 80:80 -e ASPNETCORE_ENVIRONMENT=$(EnvironmentName) 你的镜像仓库地址/你的API镜像:版本号

其中$(EnvironmentName)是Azure DevOps流水线变量，你可以在流水线的不同部署阶段（开发阶段、生产阶段）单独给这个变量赋值，也可以通过绑定环境变量组自动拉取对应环境的值。

生效逻辑说明：修改Dockerfile移除硬编码参数后，运行时注入的ASPNETCORE_ENVIRONMENT环境变量会覆盖Dockerfile中写死的默认开发环境值，.NET Core会自动读取该变量值加载对应配置文件，无配置覆盖冲突。

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