如何通过编程批量更新Azure DevOps Pipelines至迁移后的GitHub仓库？

1. 前置准备 #

• 需拥有Azure DevOps组织的项目管理员权限，以及目标GitHub仓库的操作权限
• 安装Azure DevOps CLI工具，完成登录：az login，再设置默认组织和项目：az devops configure --defaults organization=你的组织标识 project=你的项目名
• 提前获取旧Azure Repos仓库的ID：az repos show --repository 旧仓库名称 --query id -o tsv，同时记好新GitHub仓库的所有者/仓库名格式标识

2. 筛选关联旧仓库的流水线 #

用Azure DevOps CLI结合jq（需提前安装）筛选出所有绑定旧仓库的流水线，导出为列表文件：

# 导出流水线ID和名称到文本文件
az pipelines list --query "[?repository.id=='旧仓库ID'].[id,name]" -o tsv > pipelines-to-migrate.txt

如果不想用jq，直接用CLI的内置查询语法也能完成筛选，确保只拿到需要迁移的流水线清单。

3. 创建GitHub服务连接 #

如果还没建立Azure DevOps到目标GitHub仓库的服务连接，先创建一个：

# 替换为你的GitHub个人访问令牌（需包含repo权限）
az devops service-endpoint github create --name "GitHub-自定义连接名" --github-url "https://github.com/所有者/仓库名" --personal-access-token "你的GitHub PAT"

创建完成后，获取该服务连接的ID：

az devops service-endpoint list --query "[?name=='GitHub-自定义连接名'].id" -o tsv

4. 批量更新流水线关联 #

编写脚本批量处理流水线，以下提供两种脚本示例：

Shell脚本示例 #

#!/bin/bash

# 替换为实际的旧仓库ID、GitHub服务连接ID、新GitHub仓库标识
OLD_REPO_ID="旧仓库ID"
NEW_SERVICE_ENDPOINT_ID="GitHub服务连接ID"
NEW_GITHUB_REPO="所有者/仓库名"

# 遍历流水线列表
while read -r PIPELINE_ID PIPELINE_NAME; do
  echo "正在更新流水线: $PIPELINE_NAME ($PIPELINE_ID)"
  # 导出当前流水线配置
  az pipelines show --id $PIPELINE_ID --query "configuration" -o json > pipeline-config.json
  
  # 修改配置中的仓库关联信息
  jq --arg se_id "$NEW_SERVICE_ENDPOINT_ID" --arg repo "$NEW_GITHUB_REPO" \
    '.repository = {id: $repo, type: "GitHub", name: $repo, url: "https://github.com/" + $repo, serviceEndpointId: $se_id}' \
    pipeline-config.json > updated-pipeline-config.json
  
  # 应用更新后的配置
  az pipelines update --id $PIPELINE_ID --configuration updated-pipeline-config.json
  
  # 清理临时文件
  rm pipeline-config.json updated-pipeline-config.json
done < pipelines-to-migrate.txt

PowerShell脚本示例 #

# 替换为实际参数
$oldRepoId = "旧仓库ID"
$newServiceEndpointId = "GitHub服务连接ID"
$newGitHubRepo = "所有者/仓库名"

# 获取待迁移流水线列表
$pipelines = az pipelines list --query "[?repository.id=='$oldRepoId'].[id,name]" -o tsv | ConvertFrom-Csv -Header Id,Name

foreach ($pipeline in $pipelines) {
    Write-Host "正在更新流水线: $($pipeline.Name) ($($pipeline.Id))"
    # 获取当前流水线配置
    $config = az pipelines show --id $pipeline.Id --query "configuration" -o json | ConvertFrom-Json
    # 替换仓库关联信息
    $config.repository = @{
        id = $newGitHubRepo
        type = "GitHub"
        name = $newGitHubRepo
        url = "https://github.com/$newGitHubRepo"
        serviceEndpointId = $newServiceEndpointId
    }
    # 导出更新后的配置并应用
    $updatedConfig = $config | ConvertTo-Json -Depth 10
    $updatedConfig | Out-File -FilePath "updated-config.json"
    az pipelines update --id $pipeline.Id --configuration "updated-config.json"
    # 清理临时文件
    Remove-Item "updated-config.json"
}

5. 验证迁移效果 #

• 随机抽查部分流水线，确认其仓库关联已切换到目标GitHub仓库
• 手动触发1-2条流水线运行，验证是否能正常拉取GitHub代码并执行原有CI/CD流程

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