如何使用dotnet-isolation创建Azure Function App？解决.NET5隔离模式创建中的门户、CLI异常及CI/CD前置问题

我来帮你一步步拆解并解决这些实际踩过的坑，应该能帮你顺利推进CI/CD流程：

问题1：Azure门户中找不到.NET5版本选项 #

这是因为**.NET5是非长期支持（LTS）版本**，Azure官方在2022年5月结束了对它的官方支持，所以门户已经移除了直接选择.NET5的入口。不过对于隔离模式的Function App，我们可以通过配置绕开这个限制：

• 先在门户中选择.NET 6 (预览版)创建Function App（必须确保Functions版本选v4，因为隔离模式依赖v4宿主环境）
• 创建完成后，进入Function App的配置 > 应用设置，添加/修改两个关键环境变量：
  • FUNCTIONS_WORKER_RUNTIME 设置为 dotnet-isolated
  • DOTNET_VERSION 设置为你项目使用的具体.NET5版本（比如5.0.17）

问题2：Azure CLI指定dotnet-isolated作为--runtime报错 #

这个问题的核心是Azure CLI版本的兼容性：

• 旧版本的Azure CLI并没有将dotnet-isolated加入--runtime的可选枚举值中，所以会提示参数无效。首先要把你的Azure CLI升级到最新稳定版：

  az upgrade
  

• 即使升级后仍遇到问题，也不用纠结--runtime参数——真正决定worker运行时的是应用设置里的FUNCTIONS_WORKER_RUNTIME。你可以在创建时直接通过--app-settings参数指定所需配置，示例命令：

  az functionapp create \
    --name your-function-app-name \
    --resource-group your-resource-group \
    --consumption-plan-location eastus \
    --runtime dotnet \
    --runtime-version 6.0 \
    --functions-version 4 \
    --app-settings "FUNCTIONS_WORKER_RUNTIME=dotnet-isolated" "DOTNET_VERSION=5.0.17"
  

• 创建完成后，可用以下命令验证配置是否生效：

  az functionapp config appsettings list --name your-function-app-name --resource-group your-resource-group
  

问题3：推进CI/CD流程的可行方案 #

要确保CI/CD流程自动化顺畅，推荐两种实践方式：

方式1：CLI创建+内置配置（快速适配现有流程） #

1. 在CI/CD流水线中直接执行上述带--app-settings参数的az functionapp create命令，一步到位创建符合要求的Function App
2. 部署你的.NET5隔离模式代码（隔离模式代码的部署方式和普通Function一致，可使用az functionapp deployment source config或流水线部署任务）
3. 可选：添加一个验证步骤，检查应用设置是否正确，避免因配置遗漏导致部署失败

方式2：ARM模板/Bicep创建（适合长期稳定的基础设施即代码） #

如果你的流程需要更可控的自动化部署，建议用ARM模板或Bicep定义Function App，直接在模板中预置所有必要配置。示例ARM模板片段：

"siteConfig": {
  "appSettings": [
    {
      "name": "FUNCTIONS_WORKER_RUNTIME",
      "value": "dotnet-isolated"
    },
    {
      "name": "DOTNET_VERSION",
      "value": "5.0.17"
    },
    {
      "name": "FUNCTIONS_EXTENSION_VERSION",
      "value": "~4"
    }
  ]
}

用模板创建的好处是，Function App一经创建就完全符合运行时要求，无需后续手动修改，非常适合自动化的CI/CD流水线。

最后补充：.NET5虽然已停止官方支持，但隔离模式的Function App只要配置好对应的环境变量，仍然可以正常运行，不会影响业务功能。

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