跳转到内容
安装

`ansible_version` 报告参照 ansible-core 版本

决策记录 0003。

状态 日期
已接受 2026-09-06

许多 Galaxy role 会根据 ansible_version.full 或 ansible_version.major 选择代码路径。Volant 不是 Ansible,但它复现某一个 ansible-core 版本的行为(见 ADR 0002)。不定义 ansible_version,会让这些 role 因变量未定义而失败;发明一个 Volant 专属的值,又会把它们引向未经测试的路径。

ansible_version 保存 Volant 所复现的参照版本,采用 role 所期望的字典形状(full、major、minor、revision、string)。另有一个单独的 volant_version 变量保存 Volant 自己的版本。

  • 为参照版本编写的 role,其行为与在参照版本下一致。
  • 参照版本变动时(ADR 0002 的流程),ansible_version 在同一次变更中随之变动。
  • 需要区分 Volant 与 Ansible 的 playbook,可以测试 volant_version is defined。