Azure Bicep模块引用BCP192报错及模块用法咨询

问题描述 #

• 对两种Azure Bicep资源创建方式存在疑问：部分开发者直接使用resource关键字创建资源，另一部分则使用Azure官方ResourceModules仓库的模块。
• 使用仓库中的虚拟机模块代码时出现BCP192错误，不清楚br:开头的引用行作用，需要解释含义并解决报错。

错误信息 #

Error BCP192: Unable to restore the module with reference "br:bicep/modules/network.virtual-network:1.0.0": Retry failed after 4 tries. Retry settings can be adjusted in ClientOptions.Retry or by configuring a custom retry policy in ClientOptions.RetryPolicy. (The requested name is valid, but no data of the requested type was found. (bicep:443)) (The requested name is valid, but no data of the requested type was found. (bicep:443)) (The requested name is valid, but no data of the requested type was found. (bicep:443)) (The requested name is valid, but no data of the requested type was found. (bicep:443))

代码片段 #

module virtualMachine 'br:bicep/modules/compute.virtual-machine:1.0.0' = {
  name: '${uniqueString(deployment().name, location)}-test-cvmwinmin'
  params: {
    // Required parameters
    adminUsername: adminusername
    imageReference: {
      offer: 'WindowsServer'
      publisher: 'MicrosoftWindowsServer'
      sku: '2022-datacenter-azure-edition'
      version: 'latest'
    }
    nicConfigurations: [
      {
        ipConfigurations: [
          {
            name: 'ipconfig01'
            subnetResourceId: '<subnetResourceId>'
          }
        ]
        nicSuffix: '-nic-01'
      }
    ]
    osDisk: {
      diskSizeGB: '128'
      managedDisk: {
        storageAccountType: 'Premium_LRS'
      }
    }
    osType: 'Windows'
    vmSize: 'Standard_DS2_v2'
    // Non-required parameters
    adminPassword: '<adminPassword>'
    enableDefaultTelemetry: '<enableDefaultTelemetry>'
    location: '<location>'
    name: 'cvmwinmin'
  }
}

解答 #

1. br:开头引用的含义 #

br:是Bicep模块注册表的前缀，用于引用发布到Azure容器注册表或Microsoft公共Bicep注册表中的预构建模块。格式为br:<注册表名称>/<模块路径>:<版本号>，你代码中的br:bicep/modules/compute.virtual-machine:1.0.0指向的是Microsoft公共注册表中的虚拟机官方模块。

2. BCP192错误解决方法 #

报错核心是无法访问指定的模块注册表，可通过以下方式解决：

• 检查网络连通性：确认你的环境能访问Microsoft公共Bicep注册表地址bicep.azurecr.io，企业内网环境需配置代理或开放该域名的访问权限。
• 改用本地模块引用：如果无法访问公共注册表，直接从ResourceModules仓库下载虚拟机模块的本地文件，然后替换为本地路径引用，示例：

  module virtualMachine './compute/virtual-machine/main.bicep' = {
    // 其余配置保持不变
  }
  

• 验证模块版本：确认引用的1.0.0版本是否存在，可在对应模块的仓库页面查看可用稳定版本，改用最新版本尝试。

3. 两种资源创建方式对比 #

• 直接使用resource关键字：
  • 优势：完全自定义资源配置，灵活度高，适合简单场景或需要精细控制资源属性的需求。
  • 劣势：需手动编写所有资源属性，重复代码多，长期维护成本高。
• 使用官方ResourceModules模块：
  • 优势：模块经过Azure官方验证，遵循最佳实践，支持丰富参数配置，减少重复代码，提升部署效率。
  • 劣势：依赖外部模块，网络受限场景下可能无法获取，部分定制化场景灵活性稍弱。

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