Azure Bicep：如何让Named Value模块优先于API模块部署？

我有两个Azure Bicep模块：一个包含Named Value资源，另一个包含API及操作资源，通过main.bicep调用这两个模块。由于API模块的策略文件policy.xml依赖Named Value模块中的资源，必须确保Named Value模块先于API模块部署。

之前尝试的两种错误配置：

• 在apiModule中添加parent: namedValues，VS Code提示错误：The property "parent" is not allowed on objects of type "module". Permissible properties include "dependsOn"
• 改用dependsOn: namedValues，报错：The property "dependsOn" expected a value of type "(module[] | (resource | module) | resource[])[]" but the provided value is of type "module"

正确的配置方式 #

Bicep的dependsOn属性要求传入数组类型，哪怕只依赖一个模块，也要用数组包裹。修改main.bicep里apiModule的定义，把dependsOn的值改成数组形式即可：

// 部署Named Value模块
module namedValues './named-values.bicep' = {
  name: 'deploy-named-values'
  params: {
    // 填写模块所需参数
  }
}

// 部署API模块并指定依赖
module apiModule './api-resources.bicep' = {
  name: 'deploy-api-resources'
  params: {
    // 填写模块所需参数
  }
  dependsOn: [namedValues] // 将依赖模块放入数组中
}

关键说明 #

• parent属性仅用于资源间的层级关联（比如子资源依附父资源），模块之间不能用parent来控制部署顺序，必须使用dependsOn。
• dependsOn设计为支持多依赖场景，因此参数必须是数组类型，哪怕只有一个依赖项也需要用[]包裹。

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