如何在ADF ARM模板中实现自承载集成运行时的参数化配置
ADF自托管集成运行时名称未进入ARM模板参数文件的解决方法
- 核心原因:ADF默认导出ARM模板时,仅会将链接服务中引用的IR配置识别为待参数化项,不会将SHIR资源本身的名称纳入顶层参数范围,即便在ADF编辑器内完成IR的参数化配置,也不会同步生成对应的参数条目
- 调整ADF侧的ARM发布配置规则
- 进入ADF Studio「管理」板块的「ARM 发布配置」页,在自定义参数映射的JSON配置段中,手动添加针对SHIR资源的参数化规则,将
Microsoft.DataFactory/factories/integrationRuntimes资源下的name字段标记为需要导出的参数;默认配置中SHIR的name字段属于固定硬编码值,不会被自动导出到参数文件
- 进入ADF Studio「管理」板块的「ARM 发布配置」页,在自定义参数映射的JSON配置段中,手动添加针对SHIR资源的参数化规则,将
- CI流水线侧的兜底参数改造
- 流水线拉取ADF发布的ARM制品后,做两层参数适配,无需手动修改仓库内固化的模板文件:
- 修改
arm_template.json内SHIR资源的名称字段,将硬编码值替换为参数引用表达式,格式为[concat(parameters('factoryName'), '/', parameters('selfHostedIrName'))] - 在
arm_template_parameters.json中新增字符串类型的selfHostedIrName参数,将该参数的取值绑定到DevOps变量组中对应环境的SHIR名称变量,实现部署时按环境动态传入
- 修改
- 流水线拉取ADF发布的ARM制品后,做两层参数适配,无需手动修改仓库内固化的模板文件:
- 常见踩坑点提示
- 不要依赖ADF画布内的前端参数绑定配置实现ARM层参数化:这类配置仅在ADF设计态生效,不会同步到导出的ARM模板结构中
- 如果使用共享关联模式的SHIR,需要额外在参数中加入关联IR的资源ID,仅传入名称会导致关联关系匹配失败
- 模板修改完成后先执行ARM部署干跑校验,确认参数替换后不会出现硬编码资源名导致的跨环境部署冲突
内容的提问来源于stack exchange,提问作者Aneesh
相关产品推荐
相关产品推荐

