Azure CI/CD中Azure Functions的local.settings.json值转换方案咨询

我刚好之前处理过类似的需求，给你分享两种实用的方案，完全符合你不想额外创建JSON文件的要求：

方案1：用Replace Tokens任务替换local.settings.json的占位符 #

如果你的场景需要在构建阶段调整local.settings.json的内容（比如用于自动化测试），可以用这个方法：

• 先在仓库里的local.settings.json中，把需要动态替换的配置项改成占位符，比如：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "#{AzureWebJobsStorage}#",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "CustomApiKey": "#{CustomApiKey}#"
  }
}

• 在Azure CI/CD流水线中添加Replace Tokens任务（这是Azure DevOps Marketplace的官方扩展，直接就能搜到），配置参数：
  • 根目录：指定local.settings.json所在的项目路径，比如$(System.DefaultWorkingDirectory)/YourFunctionAppProject
  • 目标文件：填local.settings.json
  • 令牌前缀/后缀：分别设为#{和}#（和你占位符的格式对应）
• 在流水线的变量组或管道变量中，定义好对应占位符的实际值（敏感值记得设为「保密」），任务会自动完成替换。
• 如果需要把修改后的文件包含到发布包，在dotnet publish任务里加参数确保它被复制：

dotnet publish --configuration Release --output $(Build.ArtifactStagingDirectory) /p:CopyToPublishDirectory=Always

方案2：直接给Function App设置应用配置（更推荐的Azure最佳实践） #

其实Azure Functions运行时并不依赖发布包里的local.settings.json——它会读取Azure门户中配置的应用设置。所以跳过文件转换，直接在CD阶段推送配置更合理：

• 先在流水线的变量组中，把所有需要的应用设置定义好（比如AzureWebJobsStorage、CustomApiKey），敏感值设为保密。
• 添加Azure CLI任务，选择你的目标Azure订阅，然后运行这条命令：

az functionapp config appsettings set --name <你的Function App名称> --resource-group <你的资源组名称> --settings "AzureWebJobsStorage=$(AzureWebJobsStorage)" "CustomApiKey=$(CustomApiKey)" "FUNCTIONS_WORKER_RUNTIME=dotnet"

• 这条命令会直接把变量里的值同步到Function App的应用设置中，完全不需要碰local.settings.json，也符合Azure Functions的运行机制。

额外提示 #

• 绝对不要把敏感信息硬编码到local.settings.json里，始终用Azure DevOps的变量组或者Azure密钥保管库来管理。
• 如果只是为了发布Function App，方案2是更简洁的选择，因为它直接对接Azure的原生配置体系，不需要额外处理文件。

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