如何在使用Visual Studio部署时将Azure Functions设为初始禁用状态

我刚好折腾过这个需求，有几个实用的办法能让你用Visual Studio部署Azure Functions时，让它一开始就处于禁用状态，不用部署完再手动去关：

• 通过本地配置文件同步设置
  在你的项目根目录的local.settings.json文件里，给目标函数添加禁用配置。格式是AzureWebJobs.<你的函数名>.Disabled，值设为true。举个例子，如果你的函数叫OrderProcessingTrigger，配置就像这样：

  {
    "IsEncrypted": false,
    "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "AzureWebJobs.OrderProcessingTrigger.Disabled": "true"
    }
  }
  

  部署的时候Visual Studio会把这个配置同步到Azure的Function App里，这样函数部署完成后直接就是禁用状态。

• 提前在Azure门户配置应用设置
  要是不想改动本地代码文件，你可以先登录Azure门户，找到对应的Function App，进入「配置」→「应用程序设置」页面，手动添加AzureWebJobs.<你的函数名>.Disabled这个设置，值设为true。之后用VS部署时，只要不勾选「清除现有资源」这类会覆盖配置的选项，部署流程就不会修改这个设置，函数自然保持禁用状态。

• 用基础设施即代码（ARM/Bicep）定义配置
  如果你是用ARM模板或者Bicep来管理Function App的部署，直接在模板里的应用设置部分定义禁用规则就行。比如Bicep的写法：

  resource functionApp 'Microsoft.Web/sites@2022-09-01' = {
    name: functionAppName
    location: location
    properties: {
      serverFarmId: appServicePlan.id
      siteConfig: {
        appSettings: [
          {
            name: 'AzureWebJobs.OrderProcessingTrigger.Disabled'
            value: 'true'
          }
          // 其他必要的应用设置...
        ]
      }
    }
  }
  

  这种方式适合自动化部署场景，部署完成后函数直接处于禁用状态。

注意事项 #

• 函数名要严格匹配，Azure里的函数名是区分大小写的，别写错了导致配置不生效。
• 之后要启用函数的话，只需要把对应配置的值改成false，或者直接删除这个配置项就行，不管是本地修改后重新部署，还是在Azure门户里直接修改都可以。

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