使用ARM模板通过VSTS仓库部署Azure WebApp遇预配失败，咨询模板所需URL

我来帮你搞定这个预配失败的问题——首先得明确，VSTS现在已经更名为Azure DevOps了，不过旧的URL格式也还能用，下面是你需要的正确配置细节：

正确的仓库URL格式 #

你需要根据你的Azure DevOps组织类型选择对应的URL：

• 新格式（推荐）：https://dev.azure.com/{你的组织名}/{你的项目名}/_git/{仓库名}
  比如你的组织叫MyDevOrg，项目是WebAppProject，仓库是MainRepo，那URL就是https://dev.azure.com/MyDevOrg/WebAppProject/_git/MainRepo
• 旧VSTS格式：https://{你的账户名}.visualstudio.com/{你的项目名}/_git/{仓库名}
  比如https://MyVSTSAccount.visualstudio.com/WebAppProject/_git/MainRepo，这个格式目前依然兼容，但更推荐用新的dev.azure.com域名。

ARM模板中的完整配置示例 #

在你的ARM模板里，需要在WebApp的sourcecontrols/web资源节点下配置正确的URL，这里给你一个可参考的完整片段：

"resources": [
    {
        "type": "Microsoft.Web/sites",
        "apiVersion": "2022-03-01",
        "name": "[parameters('webAppName')]",
        "location": "[parameters('location')]",
        "properties": {
            "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]"
        },
        "resources": [
            {
                "type": "sourcecontrols/web",
                "apiVersion": "2022-03-01",
                "name": "web",
                "dependsOn": [
                    "[resourceId('Microsoft.Web/sites', parameters('webAppName'))]"
                ],
                "properties": {
                    "repoUrl": "https://dev.azure.com/MyDevOrg/WebAppProject/_git/MainRepo", // 替换成你的正确URL
                    "branch": "main", // 注意分支名要和仓库实际分支一致，现在主流是main而非master
                    "isManualIntegration": false,
                    "deploymentRollbackEnabled": true,
                    // 如果需要指定运行时配置，可以添加下面的节点
                    "gitHubActionConfiguration": {
                        "codeConfiguration": {
                            "runtimeStack": "DOTNETCORE",
                            "runtimeVersion": "6.0"
                        }
                    }
                }
            }
        ]
    }
]

避免预配失败的关键注意事项 #

• URL准确性：组织名、项目名、仓库名的大小写要和Azure DevOps里完全一致，这些都是大小写敏感的
• 权限配置：如果你的仓库是私有仓库，要确保部署用的身份（服务主体或PAT）有仓库的读取权限，否则会因为权限不足导致预配失败
• API版本：尽量使用较新的API版本（比如2022-03-01及以上），旧版本可能对新的Azure DevOps URL兼容性不好
• 分支验证：确认你填写的分支名确实存在于仓库中，比如很多仓库已经把默认分支从master改成了main

预配失败后的排查步骤 #

如果还是失败，去Azure门户的WebApp部署中心查看具体的错误日志，里面会明确告诉你是URL无效、权限不足还是分支不存在，针对性解决就好。

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