如何在Azure DevOps中实现全组织README文件聚合至中心Wiki？

现成工具情况 #

目前Azure DevOps官方没有提供直接跨组织所有项目、仓库自动汇总README到指定Wiki的现成工具。部分第三方扩展仅支持单一项目范围内的操作，跨项目的汇总需求仍需通过自定义脚本结合Azure DevOps API实现。

自定义实现步骤 #

1. 准备运行环境 #

• 安装Azure CLI并完成目标组织的登录认证；若使用Azure Pipeline执行脚本，可直接利用内置的Azure DevOps服务连接完成授权。
• 选择PowerShell、Python等脚本语言编写逻辑，以下以PowerShell为例说明流程。

2. 遍历组织内所有项目 #

通过Azure CLI或REST API获取组织下全部项目列表：

• Azure CLI命令：

  az devops project list --organization https://dev.azure.com/OrganizationA --output json
  

• REST API请求：

  GET https://dev.azure.com/OrganizationA/_apis/projects?api-version=7.1-preview.4
  

3. 遍历每个项目下的仓库 #

对每个项目，获取其下所有Git仓库信息：

• Azure CLI命令：

  az repos list --project {ProjectName} --organization https://dev.azure.com/OrganizationA --output json
  

• REST API请求：

  GET https://dev.azure.com/OrganizationA/{ProjectId}/_apis/git/repositories?api-version=7.1-preview.1
  

4. 检查仓库master分支的README文件 #

针对每个仓库，验证master分支是否存在README.md：

• 使用REST API查询文件：

  GET https://dev.azure.com/OrganizationA/{ProjectId}/_apis/git/repositories/{RepoId}/items?path=/README.md&versionDescriptor.version=master&versionDescriptor.versionType=branch&api-version=7.1-preview.1
  

• 若返回状态码200，说明文件存在，记录以下信息：
  • 仓库名称与所属项目名称
  • README文件的直接访问URL（构造格式：https://dev.azure.com/OrganizationA/{ProjectName}/_git/{RepoName}?path=/README.md&version=GBmaster）
  • 仓库描述信息

5. 生成汇总Markdown内容 #

将收集到的信息整理为结构化的Markdown列表，示例格式：

# 组织仓库README汇总
- **[Repo I (Project A)](https://dev.azure.com/OrganizationA/ProjectA/_git/RepoI?path=/README.md&version=GBmaster)**：仓库描述文本
- **[Repo II (Project B)](https://dev.azure.com/OrganizationA/ProjectB/_git/RepoII?path=/README.md&version=GBmaster)**：仓库描述文本

6. 更新Project C的Wiki页面 #

通过Wiki REST API完成页面的创建或更新：

• 若页面已存在，使用PUT请求更新：

  PUT https://dev.azure.com/OrganizationA/ProjectC/_apis/wiki/wikis/{WikiId}/pages?path=README汇总&api-version=7.1-preview.2
  

• 若页面不存在，改用POST请求创建；请求体中传入生成的Markdown内容。

7. 自动化定时执行 #

将脚本配置到Azure Pipeline中，设置每日定时触发，实现汇总内容的自动更新。

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