跳到内容

meta-runtime

此规则检查 meta/runtime.yml 中的 requires_ansible 键是否与当前支持的 ansible-core 版本列表匹配。

此规则可以生成如下消息:

  • meta-runtime[unsupported-version] - requires_ansible 键必须引用当前支持的版本,例如:>=2.14.0、>=2.15.0、>=2.16.0
  • meta-runtime[invalid-version] - requires_ansible 不是有效的需求规范

请注意,linter 将仅允许 Ansible 的完整版本,如 2.16.0,而不允许其简短形式,如 2.16。这是一种安全措施,旨在要求作者提及他们测试过的明确版本。多年来,我们发现多次因使用简短版本而引起的问题,用户最终尝试了一个过时的版本,而该版本从未经过集合维护者的测试。

有问题的代码

# runtime.yml
---
requires_ansible: ">=2.9"
# runtime.yml
---
requires_ansible: "2.15"

正确的代码

# runtime.yml
---
requires_ansible: ">=2.15.0"

配置

除了支持的 Ansible 版本的内部列表外,用户还可以配置其他值。这允许那些想要维护需要已停止支持的 ansible-core 版本的用户。

# Also recognize these versions of Ansible as supported:
supported_ansible_also:
  - "2.14"