linter 规则——无冲突的版本约束

当编译器对某入口点及其本地模块的版本要求没有共同允许版本时,该规则会报告错误。 编译由一个编译器负责,因此必须存在满足所有适用要求的版本。

Linter 规则代码

在Bicep linter配置中使用以下数值:

no-conflicting-version-constraints

默认级别为 error。

解决方案

调整要求,确保它们至少共享一个版本。 仅检查每对模重叠是不够的;整套模需要一个共同的交集。

请考虑这个布局:

project\
  bicepconfig.json
  main.bicep
  modules\
    bicepconfig.json
    child.bicep

在 main.bicep中,指局部模:

module child './modules/child.bicep' = {
  name: 'child'
}

对于这个例子, modules\child.bicep 包含:

output message string = 'Local module'

根 bicepconfig.json 节点允许以下 2.0.0版本:

{
  "bicep": {
    "version": ">=1.0.0, <2.0.0"
  }
}

modules\bicepconfig.json要求版本达到或更高2.0.0:

{
  "bicep": {
    "version": ">=2.0.0, <3.0.0"
  }
}

没有哪个编译器版本同时满足两者,因此规则报告错误。 如果模块也支持该入口点的版本,请更新其要求以反映该兼容性:

{
  "bicep": {
    "version": ">=1.0.0, <3.0.0"
  }
}

现在,每个入口点允许的版本都被模块允许。 只有在确认受影响的Bicep文件支持这些版本后,才更改要求。 这些数字反映的是射击场的行为,而非发布的可用性。

范围与配置

该规则包含入口点,并遵循直接且传递的局部 module 引用。 没有版本要求的文件并不会缩小常见范围。 该规则不检查注册表或模板规范模块内部结构,也不扫描无关的仓库文件。

它在入口点开始时报告第一个冲突,使用该文件的有效规则级别。 诊断可以描述累积的交叉点,而不仅仅是单个文件的原始范围。

要更改电平,请配置 analyzers.core.rules.no-conflicting-version-constraints.level 为 error、 warning、 info或 off。 更改这个设置不会改变 BCP456,它会检查正在运行的编译器。

通过此规则意味着数值约束重叠。 它不能证明有匹配的版本发布,运行的编译器匹配,或者每个入门点版本都能适用于每个模块。 关于最后的检查,请参见 无不兼容入口版本。

后续步骤