如何将Azure DevOps中GitHub相关vstfs链接转为原始GitHub URL

核心思路 #

Azure DevOps中关联外部GitHub仓库生成的vstfs:///GitHub/...格式链接，无法通过内置的Resolve API直接解析，但可以通过解析URI提取关键信息 + 查询ADO服务端点API获取GitHub仓库地址的方式拼接出原始URL。

具体步骤 #

1. 解析vstfs URI提取关键参数

GitHub相关的vstfs URI结构固定：

• Commit类型：vstfs:///GitHub/Commit/{仓库GUID}/{Commit SHA}
• Pull Request类型：vstfs:///GitHub/PullRequest/{仓库GUID}/{PR编号}

以你提供的Commit示例为例：

vstfs:///GitHub/Commit/18f27ff9-bc32-hasgdha-grduhd%2fe724kjfghsfbdsnbfdsbfsb26

解码%2f为/后，拆分得到：

• 仓库GUID：18f27ff9-bc32-hasgdha-grduhd
• Commit SHA：e724kjfghsfbdsnbfdsbfsb26

2. 通过ADO Service Endpoints API查询GitHub仓库信息

调用ADO服务端点API，获取组织下所有GitHub类型的服务端点，从中匹配包含目标仓库GUID的条目，提取对应的GitHub仓库URL。

API请求地址：

GET https://dev.azure.com/{{org}}/_apis/serviceendpoint/endpoints?api-version=7.1-preview.4

返回结果中，类型为GitHub的端点会包含data字段，其中repositoryId对应仓库GUID，repositoryUrl就是原始的GitHub仓库地址（例如https://github.com/your-org/your-repo）。

示例筛选逻辑（JavaScript）：

// 假设apiResponse是API返回的端点列表
const githubEndpoints = apiResponse.value.filter(endpoint => endpoint.type === "GitHub");
const targetEndpoint = githubEndpoints.find(endpoint => 
  endpoint.data.repositoryId === "18f27ff9-bc32-hasgdha-grduhd"
);
const githubRepoUrl = targetEndpoint.data.repositoryUrl;

3. 拼接原始GitHub URL

• 对于Commit：${githubRepoUrl}/commit/${commitSha}
• 对于Pull Request：${githubRepoUrl}/pull/${prNumber}

以你的示例为例，最终得到的Commit URL为：

https://github.com/your-org/your-repo/commit/e724kjfghsfbdsnbfdsbfsb26

注意事项 #

• 调用Service Endpoints API需要具备Service Endpoints Read权限的PAT（个人访问令牌）。
• 如果你的组织中有多个GitHub服务端点，确保正确匹配仓库GUID对应的端点。
• 该方法仅适用于通过ADO官方集成关联的GitHub仓库，手动添加的ArtifactLink可能无法通过此方式解析。

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