如何解决ADF ARM模板自定义参数secretName未在CD流程显示问题

• 现有一套Azure Data Factory（ADF）管道待完成生产化部署，采用Azure DevOps经典CI/CD流程，部署目标覆盖测试、生产两套环境。
• 当前绝大多数部署参数已完成参数化配置，仅剩sql user_name、secret_name等少量参数未做参数化。
• 预期通过ADF自带的自定义参数编辑功能配置参数，实现导出ARM模板时自动生成对应参数项，无需手动修改template.json、parameter-template.json文件后再回推代码仓库。
• 目前已在ADF自定义参数配置界面完成对应参数的配置操作，相关界面如下：
  
  
• 实际运行CD流程时，ARM模板参数列表中secretName参数未正常展示，CD流程参数界面如下：
  

问题本质是「ADF侧参数配置→CI生成ARM模板→CD解析模板参数」全链路中某一个环节的匹配规则出了问题，按从上游到下游的顺序排查即可：

• 上游：ADF侧自定义参数配置不生效
  ADF的自定义参数生成逻辑严格匹配资源类型、属性路径，90%的这类问题都是配置规则写错导致的：
  • 检查secretName绑定的资源类型、属性路径是否和实际资源结构一致：如果是Key Vault类型链接服务里存储的密钥引用，secretName的路径是typeProperties.secretName；如果是数据集、管道活动里的Key Vault引用，路径层级完全不同，路径写错时ADF导出模板不会识别该规则，自然不会生成对应参数。
  • 检查参数名大小写匹配：ADF导出ARM模板时参数名大小写敏感，若配置时写的是secret_name但资源实际属性名是secretName，不会触发参数替换。
  • 避免重复配置默认参数化属性：ADF默认参数化规则已经覆盖了链接服务连接字符串、密钥引用等核心属性，同一路径重复配置会触发参数生成冲突，最终被规则过滤。
• 中游：CI环节未正确生成带新参数的ARM模板
  • 确认CI流水线拉取的分支是你配置自定义参数后发布的ADF协作分支：ADF工作室中配置的自定义参数规则，会存储在仓库根目录的arm-template-parameters-definition.json文件中，若改完配置没有点击ADF工作室的「全部发布」，或者发布对应的提交没被CI流水线拉取，生成的模板自然不会带新参数。
  • 检查CI环节ADF构建任务的配置：如果使用官方ADF构建生成ARM模板的任务，要确认任务勾选了使用ADF仓库内的自定义参数配置选项，不要手动指定本地存储的旧版自定义参数文件路径，否则任务会用旧规则覆盖你在ADF工作室里的新配置。
  • 直接下载CI流水线生成的ARM模板工件，解压后打开azuredeploy.json和azuredeploy.parameters.json，全局搜索secretName字段：如果两个文件里根本没有对应参数项，问题就出在CI生成环节；如果文件里已经存在该参数，问题出在CD环节的参数解析逻辑。
• 下游：CD环节ARM部署任务过滤了参数
  • 检查CD环节ARM部署任务是否绑定了旧版参数文件：经典发布模式下，ARM部署任务会缓存第一次导入的模板参数结构，如果后续CI生成的模板新增了参数，但任务还在引用旧的参数映射配置，会直接把新增参数过滤掉不显示。
  • 检查参数类型归类：如果你在ADF自定义参数里把secretName配置为securestring类型的Key Vault引用参数，部分版本的Azure DevOps ARM部署任务会把这类参数默认归类到「Azure Key Vault集成」配置分组下，不会显示在普通参数列表里，翻到对应配置区即可找到。

1. 先在ADF工作室手动点击「导出ARM模板」，直接从门户下载导出的模板包，检查包内是否存在secretName参数：
   • 如果门户导出的模板里都没有该参数，回到自定义参数配置页，对照对应资源的原始JSON定义修正属性路径，比如链接服务用Key Vault存储SQL账号密码的场景，需要在Microsoft.DataFactory/factories/linkedServices资源类型下，添加typeProperties.userName、typeProperties.password.secretName两个属性的参数规则。
   • 如果门户导出的模板里存在该参数，说明ADF侧配置完全正常，继续排查流水线。
2. 触发一次全新的CI运行，完成后下载关联的发布工件，对比工件内的ARM模板和门户导出的模板是否一致：
   • 如果不一致，检查CI任务拉取的ADF发布分支是否正确，确认arm-template-parameters-definition.json的最新提交已经在该分支上，同时修正CI构建任务的配置，不要硬编码引用旧的自定义参数规则文件。
3. 如果CI生成的模板和门户导出的模板一致、已经包含secretName参数，回到CD发布流程：
   • 清空现有ARM部署任务里绑定的旧模板、旧参数文件引用，重新选择CI生成的最新azuredeploy.json作为部署模板、azuredeploy.parameters.json作为参数文件，刷新任务配置后重新查看参数列表。
   • 若参数为密钥类型，直接到任务的「Azure Key Vault」配置页查找，这类安全参数不会显示在普通参数列表中，需要在该区域配置对应的Key Vault引用映射。

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