如何通过Azure ARM模板为Web应用添加Contrast .NET Core站点扩展

• 技术可行性结论：完全可行。Azure Web Apps的站点扩展支持通过ARM模板定义部署，Contrast .NET Core站点扩展作为官方上架的扩展，可直接在ARM模板中配置。

• ARM模板配置核心步骤：

  1. 获取扩展的官方名称：从已配置的Web应用导出的ARM模板中提取扩展名称（通常为Contrast.NetCore.Azure.SiteExtension），或通过Azure CLI命令az webapp site-extensions list --query "[?contains(name,'Contrast')]"验证。
  2. 在Web应用资源下添加siteExtensions子资源：将扩展配置作为Microsoft.Web/sites/siteExtensions类型的资源加入ARM模板，依赖于父Web应用资源。

• 示例ARM模板片段：

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "webAppName": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "contrastApiUrl": {
      "type": "string"
    },
    "contrastApiKey": {
      "type": "securestring"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2023-01-01",
      "name": "[parameters('webAppName')]",
      "location": "[parameters('location')]",
      "properties": {
        // 保留原有Web应用配置（如runtime、sku等）
      }
    },
    {
      "type": "Microsoft.Web/sites/siteExtensions",
      "apiVersion": "2023-01-01",
      "name": "[concat(parameters('webAppName'), '/Contrast.NetCore.Azure.SiteExtension')]",
      "dependsOn": [
        "[resourceId('Microsoft.Web/sites', parameters('webAppName'))]"
      ],
      "properties": {
        // 扩展所需的配置参数，根据Contrast官方文档填写
        "settings": {
          "contrast.api.url": "[parameters('contrastApiUrl')]",
          "contrast.api.key": "[parameters('contrastApiKey')]"
        }
      }
    }
  ]
}

• 关键注意事项：
  • 确保使用的API版本≥2022-09-01，旧版本可能不支持扩展的完整配置能力。
  • 扩展名称必须与Azure Marketplace中的名称完全一致，否则部署会失败。
  • 敏感配置（如API密钥）建议用securestring类型参数传递，避免明文暴露。
  • 部署账号需具备Web App Contributor或更高权限，确保能安装站点扩展。

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