能否通过Azure DevOps API将源组织私有项目仓库复刻到目标组织

可行性说明 #

可以实现，你可以通过Azure DevOps官方提供的Git仓库相关API完成跨组织的私有仓库复刻操作。

前置准备 #

• 分别在源组织（SourceOrganization）和目标组织（DestOrganization）生成个人访问令牌（PAT）：源组织PAT需开通代码库读取权限，目标组织PAT需开通代码库创建、写入权限
• 提前确认以下参数值：源组织名、源项目名、源仓库名，目标组织名、目标项目名

操作流程与API调用方法 #

步骤1：获取源仓库的可访问克隆地址 #

调用源组织的仓库查询API：
GET https://dev.azure.com/{sourceOrganization}/{sourceProject}/_apis/git/repositories/{repositoryName}?api-version=7.1-preview.1
请求头携带源组织的PAT做鉴权，调用成功后从返回的remoteUrl字段获取源仓库地址，在地址中嵌入源PAT后格式为：
https://{sourcePAT}@dev.azure.com/{sourceOrganization}/{sourceProject}/_git/{repositoryName}

步骤2：在目标组织创建空的目标仓库 #

调用目标组织的仓库创建API：
POST https://dev.azure.com/{destOrganization}/{destProject}/_apis/git/repositories?api-version=7.1-preview.1
请求头参数：

• Content-Type: application/json
• Authorization: Basic {base64编码后的目标PAT}
  请求体示例：

{
  "name": "自定义目标仓库名称"
}

调用成功后获取目标仓库的ID和克隆地址，嵌入目标PAT后的地址格式为：
https://{destPAT}@dev.azure.com/{destOrganization}/{destProject}/_git/{targetRepositoryName}

步骤3：完成仓库内容复刻 #

有两种实现方案可选：

• 本地脚本执行方案：直接调用git命令完成镜像同步

  # 镜像克隆源仓库到本地
  git clone --mirror {带PAT的源仓库地址}
  # 进入仓库目录
  cd {克隆生成的本地仓库文件夹名}
  # 镜像推送到目标仓库
  git push --mirror {带PAT的目标仓库地址}
  

• 服务端纯API执行方案：调用导入请求API直接在Azure DevOps服务端完成同步，无需本地操作
  调用接口：
  POST https://dev.azure.com/{destOrganization}/{destProject}/_apis/git/repositories/{targetRepositoryId}/importRequests?api-version=7.1-preview.1
  请求体示例：

  {
    "parameters": {
      "gitSource": {
        "url": "第一步获取的源仓库克隆地址",
        "overrideCredentials": {
          "username": "任意非空字符",
          "password": "{源组织PAT}"
        }
      },
      "deleteServiceEndpointAfterImportIsDone": true
    }
  }
  

注意事项 #

• PAT权限需遵循最小可用原则，操作完成后及时删除用到的PAT避免泄露
• 若源组织配置了IP访问限制，采用本地脚本执行时需要在源组织放行的IP段内操作，采用服务端导入方案需要将Azure DevOps服务IP段加入源组织白名单

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