如何将GitHub仓库文件跨项目迁移至Azure DevOps Wikis
GitHub仓库Markdown文档发布到Azure DevOps Wiki的可行方案
Azure DevOps内置的Publish code as Wiki功能本身设计上就仅支持选择当前项目内托管的代码仓库,无法直接关联外部GitHub仓库或跨项目仓库,可通过以下三种方案实现需求:
- 方案1:自动镜像同步+内置发布(推荐,可保留GitHub作为唯一维护源)
- 在目标Azure DevOps项目内新建一个空Git仓库,专门作为Wiki文档的同步镜像
- 配置GitHub侧的自动同步规则:通过GitHub Action在每次向GitHub文档分支推送提交时,自动将全量文档(保留完整目录结构)同步推送到Azure DevOps的镜像仓库
- 镜像仓库配置完成后,直接使用Publish code as Wiki功能选择该项目内镜像仓库,指定文档根目录、对应发布分支即可,后续GitHub上的文档更新会自动同步到Wiki端,无需人工干预
- 方案2:仓库导入后直接发布(适合后续维护迁移到Azure DevOps的场景)
- 在目标Azure DevOps项目内选择导入外部仓库,填入GitHub仓库的克隆地址,等待全量内容导入完成
- 导入后的仓库属于当前项目内可用仓库,直接走内置的Publish code as Wiki流程选择对应仓库、配置发布规则即可
- 方案3:对接Wiki隐藏仓库批量同步
- 每个Azure DevOps Wiki背后都对应一个独立的隐藏Git仓库,可在Wiki页面点击「克隆Wiki」获取该仓库的克隆凭据与地址
- 编写简易定时同步脚本,自动拉取GitHub仓库内的.md文档,按照Azure DevOps Wiki的目录规则调整后,推送到Wiki对应的隐藏仓库,推送完成后Wiki内容会自动更新
注意:当前产品版本未开放Publish code as Wiki功能的跨项目、外部源仓库选择权限,所有可行方案本质都是先将GitHub仓库的文档内容同步到当前Azure DevOps项目可识别的仓库范围内,再调用内置发布能力完成上线,不存在直接选择外部GitHub仓库发布的配置入口。
内容的提问来源于stack exchange,提问作者Naman Sinha
相关产品推荐
相关产品推荐

