Azure DevOps AzureCLI@2执行az bicep build报错：模块别名未识别

问题原因 #

编译main.bicep时触发BCP212错误，是因为Bicep编译工具未读取到你定义在bicepConfig.json中的myrepo和wegmans模板规范（Template Spec）模块别名，导致默认内置配置中找不到对应条目。

解决方案 #

1. 确认配置文件的正确性 #

首先检查bicepConfig.json的内容格式，确保模板规范别名定义在ts节点下（ts是Template Spec的缩写），示例配置如下：

{
  "moduleAliases": {
    "ts": {
      "myrepo": {
        "subscription": "你的订阅ID",
        "resourceGroup": "模板规范所在资源组"
      },
      "wegmans": {
        "subscription": "你的订阅ID",
        "resourceGroup": "模板规范所在资源组"
      }
    }
  }
}

同时确保该配置文件与main.bicep处于同一目录（$(Build.SourcesDirectory)/environment）。

2. 调整编译任务的工作目录 #

Bicep默认从当前工作目录加载配置文件，修改AzureCLI任务的脚本，先切换到environment目录再执行编译：

- task: AzureCLI@2
  name: validate_bicep
  displayName: Validate Bicep
  inputs:
    azureSubscription: ${{ parameters.subscriptionsId }}
    scriptType: pscore
    scriptLocation: inlineScript
    powerShellErrorActionPreference: stop
    failOnStandardError: false
    inlineScript: |
      $envDir = "$(Build.SourcesDirectory)/environment"
      ls $envDir
      cd $envDir
      az bicep build --file main.bicep

3. 显式指定配置文件路径（可选） #

如果切换目录后仍未解决，可直接通过--config-file参数指定配置文件路径：

inlineScript: |
  ls $(Build.SourcesDirectory)/environment
  az bicep build --file $(Build.SourcesDirectory)/environment/main.bicep --config-file $(Build.SourcesDirectory)/environment/bicepConfig.json

4. 更新Bicep工具版本 #

旧版本Bicep可能存在配置兼容性问题，在编译前先升级Bicep：

inlineScript: |
  az bicep upgrade
  $envDir = "$(Build.SourcesDirectory)/environment"
  ls $envDir
  cd $envDir
  az bicep build --file main.bicep

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