如何在Azure Data Factory中启用Azure DevOps Git代码库及排查灰显问题

一、如何启用Azure DevOps Git代码库 #

• 登录Azure门户，打开目标Azure Data Factory实例。
• 在左侧导航栏选择「管理」>「配置代码库」。
• 在配置页面，选择「Azure DevOps Git」作为代码库类型。
• 填写核心配置项：
  • Azure DevOps组织：选择你的DevOps组织
  • 项目名称：关联的DevOps项目
  • 存储库名称：目标Git仓库
  • 协作分支：默认选main或自定义协作分支
  • 发布分支：建议设为adf_publish（ADF会自动创建该分支用于发布流水线）
  • 根文件夹：指定ADF资源存储的根路径，如/ADF
• 勾选「启用」，点击「应用」完成配置。

二、Azure DevOps Git选项呈灰色的排查方向 #

1. 实例类型限制 #

仅新版Azure Data Factory支持Azure DevOps Git集成，**Data Factory（经典）**不支持该功能。确认你的实例为新版ADF。

2. 权限不足 #

• 登录Azure门户的账号需拥有Data Factory实例的参与者及以上权限；
• 账号需拥有目标Azure DevOps项目的项目参与者权限，确保能访问对应Git仓库；
• 若使用服务主体配置，需为服务主体分配DevOps项目的贡献者权限。

3. 已关联其他代码库 #

ADF同一时间仅能关联一个代码库（Azure DevOps Git或GitHub）。若已关联GitHub，需先解除现有配置，才能切换到Azure DevOps Git。

4. 网络/区域限制 #

若ADF部署在受限虚拟网络（VNet）中，需检查VNet出站规则是否允许访问Azure DevOps服务端点，否则会导致选项无法激活。

5. 浏览器会话问题 #

清除浏览器缓存，或使用无痕模式重新登录Azure门户，重试配置操作。

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