如何在Azure DevOps容器构建任务中使用FileTransform任务的输出结果

根因分析 #

• 最常见的原因是项目根目录的.dockerignore文件配置了排除规则，比如包含*.json、**/appsettings.json这类匹配项，导致Docker构建时不会将你修改后的appsettings.json纳入构建上下文，最终COPY到容器内的还是源码里的原始版本。
• 其次可能是FileTransform任务本身没有成功替换配置：Azure流水线的JSON变量替换要求嵌套配置的变量名用双下划线__分隔，比如要替换appsettings.json里的Db.Connection，流水线变量名必须命名为Db__Connection，秘密变量也需要遵循这个命名规则。
• 极少数情况是FileTransform的路径配置错误，导致修改的不是你Docker构建时使用的配置文件。

排查与修复步骤 #

1. 验证FileTransform任务执行结果
   在FileTransform任务和Docker任务之间新增命令行任务，输出修改后的配置文件内容，确认替换是否生效：

- task: CmdLine@2
  displayName: Verify transformed appsettings
  inputs:
    script: cat $(Build.SourcesDirectory)/MyApp/appsettings.json

如果输出的内容没有替换成功，检查流水线变量的命名是否符合双下划线分隔规则。

2. 修改.dockerignore配置
   打开项目根目录的.dockerignore文件，删除所有匹配appsettings.json的排除规则，确保修改后的配置文件可以进入Docker构建上下文。

3. （可选优化）避免敏感配置打入镜像
   如果你的配置包含敏感信息，不建议直接将替换后的配置打进镜像，可以后续通过容器运行时的环境变量注入配置，dotnet会优先读取环境变量的值覆盖appsettings.json里的配置，安全性更高。

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