如何在Azure Git新建仓库时自动触发指定分支创建？

下面是几种实用的实现方式，覆盖从脚本到无服务器的场景：

方案一：Azure DevOps服务钩子 + PowerShell脚本（自托管执行） #

这是最直接的方式，通过监听仓库创建事件触发脚本自动生成分支：

1. 配置服务钩子监听事件

   • 登录Azure DevOps组织，进入「组织设置」→「服务钩子」→「创建订阅」
   • 选择触发事件为「Git仓库创建」，可指定监控单个项目或整个组织
   • 目标服务选「PowerShell」，关联你的自托管代理（需确保代理能访问Azure DevOps API）

2. 编写分支创建脚本
   脚本从事件payload中提取新仓库信息，调用Azure DevOps REST API基于默认分支创建所需分支。示例代码：

   # 配置参数
   $orgUrl = "https://dev.azure.com/你的组织名称"
   $pat = "你的个人访问令牌（需拥有Code读写权限）"
   $base64Auth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))
   
   # 从服务钩子传递的环境变量获取项目和仓库ID
   $projectName = $env:SYSTEM_TEAMPROJECT
   $repoId = $env:REPO_ID
   
   # 获取仓库默认分支的ObjectID
   $refsUrl = "$orgUrl/$projectName/_apis/git/repositories/$repoId/refs?filter=heads&api-version=7.1-preview.1"
   $defaultBranch = (Invoke-RestMethod -Uri $refsUrl -Headers @{Authorization="Basic $base64Auth"}).value | Where-Object {$_.isDefault -eq $true}
   
   # 批量创建分支
   $targetBranches = @("development", "release", "hotfix")
   foreach ($branch in $targetBranches) {
       $createUrl = "$orgUrl/$projectName/_apis/git/repositories/$repoId/refs?api-version=7.1-preview.1"
       $body = @{
           name = "refs/heads/$branch"
           oldObjectId = $defaultBranch.objectId
       } | ConvertTo-Json
   
       try {
           Invoke-RestMethod -Uri $createUrl -Method Post -Headers @{Authorization="Basic $base64Auth"} -Body $body -ContentType "application/json"
           Write-Host "分支 $branch 创建成功"
       }
       catch {
           if ($_.Exception.Response.StatusCode -eq "Conflict") {
               Write-Host "分支 $branch 已存在，跳过创建"
           }
           else {
               throw $_
           }
       }
   }
   

   • 注意：PAT要赋予「Code (Read & Write)」权限，脚本需部署在有网络访问权限的代理上

方案二：Azure函数 + Azure DevOps API（无服务器方案） #

不想维护自托管代理的话，用Azure函数接收事件并执行分支创建：

1. 创建Azure函数

   • 在Azure门户创建一个PowerShell或C#语言的HTTP触发函数
   • 函数逻辑：解析请求中的事件payload，调用Azure DevOps API创建分支（逻辑和方案一的脚本类似）

2. 配置服务钩子

   • 回到Azure DevOps服务钩子，选择「Web钩子」作为目标服务，将函数的HTTP端点填入URL
   • 设置请求头包含身份验证信息（比如将PAT放在请求头里，避免硬编码）

3. 优势

   • 无需维护代理，由Azure负责函数的运行和扩缩容
   • 可以轻松添加日志、监控等运维能力

方案三：组织级分支策略模板（辅助规范） #

配合前两个方案，用分支策略模板确保仓库必须符合分支规范：

• 进入Azure DevOps「组织设置」→「仓库」→「分支策略模板」
• 创建模板，指定必须存在的分支名称（development、release、hotfix），并应用到所有新项目或现有项目
• 这样即使手动创建仓库，也会强制要求存在指定分支，配合自动创建脚本形成闭环

核心注意点 #

• 权限控制：执行脚本/函数的身份（PAT或服务主体）必须拥有目标仓库的读写权限
• 事件过滤：服务钩子可设置过滤条件，只监控特定项目的仓库创建事件，减少无效执行
• 错误处理：脚本/函数中要添加分支已存在的判断，避免重复创建导致的报错

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