CI/CD部署含Managed private endpoint的ADF时报ResourceDeploymentFailure错误

问题根因排查及解决方案 #

1. 资源提供程序注册校验 #

先确认prod订阅下Microsoft.Network资源提供程序已完成注册，跨资源组部署托管私有终结点时未注册该RP会直接导致预配失败：

• 进入Azure Portal prod订阅页，左侧菜单选择「资源提供程序」
• 搜索Microsoft.Network，确认状态为「已注册」，若未注册手动触发注册，等待10分钟后重试部署
• 同步校验Microsoft.Storage资源提供程序状态为已注册

2. ADF托管标识权限配置 #

staging环境ADF和ADLS同属一个资源组，ADF系统托管标识默认有对应资源操作权限，prod跨资源组场景下需要额外授权：

• 进入prod ADF的「标识」页，复制系统分配托管标识的对象ID
• 进入ADLS所在资源组rg-dw-prod的IAM页，添加角色分配
• 选择「存储帐户专用终结点连接审批者」角色，分配对象为刚才复制的ADF托管标识，保存后等待5分钟重试部署

3. 子网策略校验 #

托管私有终结点关联的子网必须禁用专用终结点网络策略，否则部署会失败：

• 找到ADF托管私有终结点使用的虚拟网络子网
• 进入子网配置页，确认「专用终结点网络策略」设置为「已禁用」
• 若需命令行校验可执行：az network vnet subnet show --name <子网名称> --vnet-name <VNet名称> --resource-group <VNet所属资源组> --query privateEndpointNetworkPolicies，返回Disabled为正常状态

4. ADLS私有终结点配置校验 #

检查prod ADLS的网络配置是否符合要求：

• 进入prod ADLS的「网络」页，确认已勾选「允许受信任的Microsoft服务访问此存储帐户」
• 确认私有终结点连接审批模式为「自动」，若为手动模式需先调整为自动，或部署完成后手动审批连接再重新运行部署任务

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