启用ADF全局参数入ARM模板后无法在CI/CD中覆写的问题

1. 关于官方文档理解的正确性 #

你的理解不完全准确：启用"Include global parameters in ARM template"后，全局参数不会自动加入ARMTemplateParametersForFactory.json，而是生成独立的globalParameters/_GlobalParameters.json文件。官方文档提到的无需PowerShell脚本覆写，是指可通过ARM模板部署直接处理这个独立文件，而非合并到常规参数文件。

2. 可能遗漏的配置点 #

• 确认全局参数的发布状态：必须将全局参数从"编辑模式"切换到"LIVE模式"，且完成发布操作（仅启用ARM模板选项但未发布参数不会生效）。
• 检查ADF发布分支完整性：确认adf_publish分支中globalParameters目录下的_GlobalParameters.json包含需覆写的参数，且参数的type和defaultValue定义正确。
• 验证ARM模板生成设置：在ADF的"ARM模板"面板中，除启用"Include global parameters in ARM template"，需确保未勾选"Exclude global parameters from ARM template"（若存在该选项），且发布时选择了包含全局参数的配置。

3. 无需PowerShell脚本的覆写方法 #

若全局参数在独立的_GlobalParameters.json中，可通过以下方式在CI/CD流水线的ARM部署步骤中覆写：

• 添加ARM模板部署任务：选择部署globalParameters/_GlobalParameters.json作为单独ARM模板，目标资源类型设为Microsoft.DataFactory/factories/globalParameters。
• 配置覆写参数：在"Override template parameters"区域，用--parameters指定环境特定值，格式示例：

  --parameters "{\"<参数名>\":{\"value\":\"<环境特定值>\"}}"
  

  比如覆写名为EnvironmentName的字符串参数：

  --parameters "{\"EnvironmentName\":{\"value\":\"Production\"}}"
  

• 设置依赖顺序：确保全局参数部署任务在主ADF工厂模板部署任务之前执行，避免依赖报错。

4. 替代方案（合并参数到常规文件） #

如果希望将全局参数合并到ARMTemplateParametersForFactory.json，可在发布后通过流水线脚本步骤（如PowerShell）手动将_GlobalParameters.json中的参数追加到常规参数文件，但这种方式需要维护脚本，不如直接部署独立文件简洁。

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