复用Bicep模块构建ARM时遇ARM-TTK未定义参数引用问题

方案1：规范Bicep模块参数传递逻辑 #

确保调用模块时，明确将外层模板的参数（或硬编码值）传递给模块内部参数，避免模块内直接引用未在顶层模板定义的参数。

• 错误示例（模块内直接使用未在顶层声明的参数）：

  // storage.bicep
  param storageAccountName string = 'sa${uniqueString(resourceGroup().id)}'
  param location string = resourceGroup().location
  

• 正确示例（外层调用时显式传递参数）：

  // test.bicep
  param location string = resourceGroup().location
  
  module storage 'storage.bicep' = {
    name: 'storageDeploy'
    params: {
      location: location
      storageAccountName: 'sa${uniqueString(resourceGroup().id)}'
    }
  }
  

  这样编译后的ARM模板中，模块参数会被正确映射，不会出现未定义的参数引用。

方案2：跳过ARM-TTK的误报规则 #

如果确认参数传递逻辑正确，仅为linter误报，可在测试时跳过Undefined parameter reference规则：

• 本地运行时：

  Test-AzTemplate -TemplatePath .\test.json -SkipRule 'Undefined parameter reference'
  

• Azure Pipeline中配置RunARMTTKTestsXPlat任务：

  - task: RunARMTTKTestsXPlat@5
    inputs:
      templateLocation: 'Linked'
      templatePath: 'test.json'
      skipRules: 'Undefined parameter reference'
  

方案3：更新ARM-TTK至最新版本 #

旧版本ARM-TTK对Bicep编译后的ARM模板兼容性不足，更新版本可修复参数识别bug：

• 本地更新：

  Update-Module -Name Az.Tools.ArmTemplateValidation -Force
  

• Azure Pipeline中使用最新版RunARMTTKTestsXPlat任务（如@5版本），避免使用旧版任务。

方案4：临时手动修正编译后的ARM模板（不推荐） #

若上述方案均无法快速生效，可临时编辑test.json，将模块内的参数引用替换为顶层已定义参数或硬编码值。但此方法仅作为应急手段，因为每次Bicep编译都会覆盖修改。

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