如何在Python v2版Azure Functions中同步appsettings.json至门户配置

Python v2编程模型不支持直接通过appsettings.json自动同步到Azure门户的应用设置，但可以通过以下两种便捷、可版本控制的方法实现需求：

方法一：使用local.settings.json + Azure Functions Core Tools 同步 #

• 将需要同步的配置放在项目根目录local.settings.json的Values节点下，示例：

  {
    "IsEncrypted": false,
    "Values": {
      "FUNCTIONS_WORKER_RUNTIME": "python",
      "MY_CUSTOM_CONFIG": "production-value",
      "STORAGE_CONNECTION_STRING": "..."
    }
  }
  

• 用Azure Functions Core Tools执行部署命令时，添加--publish-settings-only参数，即可将本地配置同步到门户：

  func azure functionapp publish <你的函数应用名称> --publish-settings-only
  

• 注意：该命令会覆盖门户中已有的应用设置，确保local.settings.json是最新的配置集合；敏感信息可通过func settings encrypt加密本地文件，部署时会自动解密同步。

方法二：用ARM/Bicep模板定义配置（基础设施即代码） #

• 编写ARM或Bicep模板，在模板中定义函数应用的siteConfig.appSettings节点，把所有配置整合到模板里，Bicep示例：

  resource functionApp 'Microsoft.Web/sites@2022-09-01' = {
    name: '<函数应用名称>'
    location: resourceGroup().location
    properties: {
      serverFarmId: appServicePlan.id
      siteConfig: {
        appSettings: [
          {
            name: 'FUNCTIONS_WORKER_RUNTIME'
            value: 'python'
          }
          {
            name: 'MY_CUSTOM_CONFIG'
            value: 'production-value'
          }
        ]
      }
    }
  }
  

• 将模板纳入代码仓库版本控制，通过Azure CLI、GitHub Actions等工具部署模板，即可自动将配置同步到门户；后续修改配置只需更新模板并重新部署。
• 优势：配置与代码完全绑定，变更可追溯，适合规模化部署场景。

额外注意事项 #

• 敏感信息（如密钥、连接字符串）不要提交到公开仓库，可改用Azure Key Vault引用，在配置中使用@Microsoft.KeyVault(SecretUri=...)格式调用密钥。
• 若用GitHub Actions部署，可结合Azure/login和Azure/functions-action，在工作流中直接指定配置变量，或读取仓库内的配置文件完成同步。

内容的提问来源于stack exchange，提问作者average.everyman