如何让DevOps YAML Pipeline使用appsettings.Staging.json部署Azure Web App

核心思路是让ASP.NET Core应用识别到Staging环境，自动加载对应配置文件，同时确保配置文件被正确打包部署，以下是几种可行方案：

方案1：在部署任务中指定环境变量 #

直接在YAML的Azure Web App部署任务里设置ASPNETCORE_ENVIRONMENT环境变量，ASP.NET Core会自动匹配加载appsettings.Staging.json。

示例YAML片段：

- stage: DeployToStaging
  jobs:
  - job: Deploy
    steps:
    - task: AzureWebApp@1
      displayName: '部署至Staging环境'
      inputs:
        azureSubscription: '<你的Azure订阅连接名>'
        appName: '<你的Web App名称>'
        package: '$(Build.ArtifactStagingDirectory)/**/*.zip'
        # 关键：设置环境变量为Staging
        appSettings: '-ASPNETCORE_ENVIRONMENT Staging'

方案2：在Azure Portal预先配置Web App环境 #

如果不想在Pipeline中硬编码配置，可直接在Azure Portal操作：

• 进入目标Web App → 「配置」→「应用程序设置」
• 添加新配置项：名称填ASPNETCORE_ENVIRONMENT，值填Staging
• 保存后，后续Pipeline部署会自动继承该配置，应用启动时将加载Staging配置文件

方案3：结合文件转换任务（需修改配置值时用） #

如果需要在部署前替换appsettings.Staging.json中的特定参数（比如数据库连接字符串），可先通过FileTransform@1任务处理配置文件，再部署：

- stage: BuildAndDeploy
  jobs:
  - job: Build
    steps:
    - task: DotNetCoreCLI@2
      displayName: '发布Staging版本'
      inputs:
        command: 'publish'
        publishWebProjects: true
        arguments: '--configuration Staging --output $(Build.ArtifactStagingDirectory)'
    - task: FileTransform@1
      displayName: '替换Staging配置参数'
      inputs:
        folderPath: '$(Build.ArtifactStagingDirectory)'
        jsonTargetFiles: '**/appsettings.Staging.json'
        # 示例：替换连接字符串，可根据需求修改
        transformRules: '-ConnectionStrings__DefaultConnection "<你的Staging数据库连接串>"'
    - task: AzureWebApp@1
      displayName: '部署至Web App'
      inputs:
        azureSubscription: '<你的Azure订阅连接名>'
        appName: '<你的Web App名称>'
        package: '$(Build.ArtifactStagingDirectory)/**/*.zip'
        appSettings: '-ASPNETCORE_ENVIRONMENT Staging'

必查注意事项 #

• 确保项目中存在appsettings.Staging.json，且.csproj文件中配置了文件复制规则：<Content Include="appsettings.Staging.json" CopyToOutputDirectory="PreserveNewest" />
• 若为.NET Framework项目，环境变量名称需改为ASPNET_ENVIRONMENT

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