CI/CD自动发布Azure Data Factory时ARM模板参数定义文件缺失报错求助

根因 #

你遇到的报错是ADF CI/CD的npm构建工具默认会从代码库根目录读取arm-template-parameters-definition.json文件，该文件用于自定义ARM模板部署时的参数化规则，你的代码库中缺少该文件或文件存放路径不符合要求，因此触发文件不存在的报错。该报错本质为日志级别设置问题，不会阻断流水线运行，工具会自动降级到默认参数规则继续构建。

修复方法 #

方案一：使用自定义参数规则（推荐） #

1. 登录ADF开发环境工作室，进入「管理」板块 → 选择「ARM模板」→ 点击「导出参数模板」，将导出的文件重命名为arm-template-parameters-definition.json
2. 将该文件提交到代码库根目录，与你的ADF工厂配置文件夹（对应你场景下的df-testfactory-dev-9999文件夹）同级存放
3. 重新运行流水线即可消除报错

方案二：使用默认参数规则 #

如果你不需要自定义参数化规则，无需新增文件，可直接修改流水线的构建命令，显式指定使用默认参数规则，即可消除警告：
修改npm run build export对应的自定义命令，添加--default-params true参数：

- task: Npm@1
  inputs:
    command: 'custom'
    customCommand: 'run build export $(Build.Repository.LocalPath) /subscriptions/xxxxxxxxx/resourceGroups/RG-Dick-DP203/providers/Microsoft.DataFactory/factories/df-testfactory-dev-9999 "ArmTemplate" --default-params true'
  displayName: 'Validate and Generate ARM template'

额外校验项 #

• 确认流水线拉取代码步骤未配置稀疏检出，完整拉取了全量代码
• 确认文件名拼写完全正确，Ubuntu运行环境对文件名大小写敏感，不要出现拼写或大小写错误

内容的提问来源于stack exchange，提问作者Dick ter Schiphorst