.NET 8应用迁移Azure容器App：appsettings.json转换方案咨询

核心解决方案选项 #

1. 复用现有File Transform任务，构建时完成配置转换 #

• 无需调整现有Azure DevOps流程，在容器构建阶段执行File Transform任务，修改镜像内的appsettings.json后再推送至容器注册表。
• 具体流程：
  • 拉取代码后，执行File Transform任务替换appsettings.json中的占位符
  • 执行docker build命令，将修改后的配置文件打包进镜像
  • 推送镜像至ACR，再部署到Azure容器应用
• 优势：完全沿用熟悉的单命令式转换逻辑，适配多应用批量迁移场景，无需改动现有密钥管理流程。

2. 利用.NET环境变量覆盖机制（无需修改配置文件） #

• .NET原生支持将环境变量映射到appsettings.json配置项，命名遵循层级结构：比如ConnectionStrings__DefaultConnection对应配置文件中的ConnectionStrings.DefaultConnection
• 在Azure容器应用中配置环境变量的方式：
  • 通过Azure DevOps的Azure Container Apps Deploy任务，在YAML中指定environmentVariables参数，或直接引用Azure Key Vault中的密钥
  • 示例YAML片段：

    - task: AzureContainerApps@1
      inputs:
        azureSubscription: '你的订阅名称'
        containerAppName: '你的容器应用名称'
        imageToDeploy: 'acr-name.azurecr.io/你的镜像:标签'
        environmentVariables: |
          ConnectionStrings__DefaultConnection=$(KeyVault.DefaultConnection)
          AppSettings__ApiUrl=$(KeyVault.ApiUrl)
    

• 优势：配置与镜像解耦，符合容器化最佳实践，无需修改镜像内容，适合动态调整配置的场景。

3. 通过Azure Key Vault实现配置注入（结合容器应用密钥引用） #

• 无需转换appsettings.json，直接在容器应用中引用Key Vault密钥作为配置：
  • 为容器应用启用系统分配托管标识，并赋予Key Vault的机密读取权限
  • 在容器应用配置中，使用@Microsoft.KeyVault(SecretUri=密钥URI)格式引用密钥，.NET会自动加载这些值作为配置项
• 示例：设置环境变量ConnectionStrings__DefaultConnection=@Microsoft.KeyVault(SecretUri=https://你的密钥库.vault.azure.net/secrets/DefaultConnection)
• 优势：敏感配置集中存储在Key Vault，避免在DevOps管道中暴露，多应用可共享同一密钥源。

常见疑问解答 #

• 是否必须将每个变量设为环境变量？
  不需要。可以选择构建时修改配置文件（方案1），或运行时通过密钥引用注入（方案3），环境变量只是其中一种便捷方式。
• 有没有单命令式的转换方式？
  方案1完全复用现有File Transform任务，保持单命令式转换逻辑，仅需将转换步骤移至Docker构建前即可，无需学习新工具。

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