寻求自动化将Azure DevOps Wiki页面迁移至Confluence的方案

一、现成工具推荐 #

• Azure DevOps Marketplace扩展：比如Confluence Publisher这类扩展，直接在Azure DevOps Pipeline中集成，配置好Confluence站点信息、认证凭据后，就能实现Wiki页面的自动同步，支持按页面路径、更新时间过滤，还能自动处理格式转换。
• 第三方同步工具：Exalate这类跨平台同步工具，支持单向或双向同步Azure DevOps Wiki与Confluence，可自定义同步规则，处理页面层级、附件等内容，适合复杂场景下的同步需求。

二、自定义脚本实现思路 #

如果需要更灵活的控制逻辑，用脚本实现是不错的选择，以Python为例：

1. 获取Azure DevOps Wiki内容
   • 通过Azure DevOps REST API，使用PAT（个人访问令牌）完成认证，先调用页面列表接口获取目标页面的ID和路径，再调用详情接口拉取页面的Markdown内容。核心代码示例：

     import requests
     azdo_pat = "your_pat_token"
     org = "your_organization"
     proj = "your_project"
     wiki_id = "your_wiki_id"
     url = f"https://dev.azure.com/{org}/{proj}/_apis/wiki/wikis/{wiki_id}/pages?api-version=7.1-preview.1"
     response = requests.get(url, auth=("", azdo_pat))
     pages = response.json()["value"]
     

2. 格式转换处理
   • Azure DevOps Wiki采用Markdown格式，Confluence支持Storage格式或原生Markdown（部分版本），可以用pandoc工具完成格式转换，在脚本中通过subprocess调用命令：pandoc -f markdown -t confluence input.md -o output.confluence。
3. 同步到Confluence
   • 使用Confluence REST API，通过邮箱+API token认证，创建或更新对应页面。核心代码示例：

     confluence_api_token = "your_api_token"
     confluence_domain = "your_confluence_domain"
     space_key = "TARGET_SPACE_KEY"
     url = f"https://{confluence_domain}/rest/api/content"
     headers = {"Content-Type": "application/json"}
     auth = ("your_email", confluence_api_token)
     payload = {
         "type": "page",
         "title": "目标页面标题",
         "space": {"key": space_key},
         "body": {
             "storage": {
                 "value": "转换后的页面内容",
                 "representation": "storage"
             }
         }
     }
     response = requests.post(url, json=payload, headers=headers, auth=auth)
     

4. 增量同步优化
   • 记录每次同步的页面最后更新时间，下次同步仅拉取更新时间晚于该记录的页面，减少不必要的API请求，提升同步效率。

三、关键注意事项 #

• 页面层级映射：需将Azure DevOps Wiki的层级路径对应到Confluence的页面父节点，确保同步后页面结构一致。
• 附件与图片处理：Wiki中的图片、附件需单独下载后上传到Confluence，并更新内容中的链接地址。
• 权限控制：确保Azure DevOps的PAT拥有Wiki读取权限，Confluence的API token拥有页面创建/编辑权限。
• 格式兼容性：部分Markdown语法（如Mermaid图表）在Confluence中需额外插件支持，同步前需确认格式兼容情况。

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