Ansible-core 2.15 移植指南 

本节讨论 ansible-core 2.14 和 ansible-core 2.15 之间的行为变化。

旨在帮助您更新 playbook、插件和 Ansible 基础设施的其他部分，以便它们能够与此版本的 Ansible 兼容。

我们建议您阅读此页面以及 ansible-core 2.15 版本变更日志，以了解您可能需要进行哪些更新。

本文档是移植集合的一部分。完整的移植指南列表可在移植指南中找到。

Playbook 

条件语句 - 由于在 ansible-core 2.15.7 中缓解了安全问题 CVE-2023-5764，包含嵌入式模板块的条件表达式可能会失败，并显示消息“Conditional is marked as unsafe, and cannot be evaluated.”，当嵌入式模板从不受信任的来源（如模块结果或标记为 !unsafe 的变量）中查询数据时。包含嵌入式模板的条件语句可能是恶意模板注入的来源，当引用不受信任的数据时，几乎总是可以重写而无需嵌入式模板。Playbook 任务条件关键字（如 when 和 until）长期以来一直显示警告，不鼓励在条件语句中使用嵌入式模板；此警告也已扩展到非任务条件语句，例如 assert 操作。
```
- name: task with a module result (always untrusted by Ansible)
  shell: echo "hi mom"
  register: untrusted_result

# don't do it this way...
# - name: insecure conditional with embedded template consulting untrusted data
#   assert:
#     that: '"hi mom" is in {{ untrusted_result.stdout }}'

- name: securely access untrusted values directly as Jinja variables instead
  assert:
    that: '"hi mom" is in untrusted_result.stdout'
```

如文档所述，如果已定义多个特定名称的处理器，则在被通知时执行的是添加到 playbook 中的最后一个处理器。在 ansible-core 2.15 之前，对于使用 include_role 任务动态包含到 playbook 中的处理器，情况并非如此。此问题已在 ansible-core 2.15 中得到解决，依赖于 ansible-core 2.14 及更早版本行为的用户可能需要相应地调整其 playbook。

例如，考虑以下情况

- include_role:
    name: foo
  vars:
    invocation: 1

- block:
   - include_role:
       name: foo
     vars:
       invocation: 2
  when: inventory_hostname == "bar"

- meta: flush_handlers

注意

此示例假设角色 foo 中有一个任务会通知角色 foo 中名为 foo_handler 的处理器。

注意

将不同的变量和/或其值附加到包含相同角色的 include_role 任务，使它们成为不同的角色。

注意

第二次调用 include_role 任务会导致包含角色中的任务和处理器，而不管 when 条件评估结果如何。 when 条件附加到包含 include_role 任务的 block，因此 when 条件在将任务和处理器包含到 playbook 中后应用于所有任务和处理器。

在 flush_handlers 任务运行时，所有主机都会在第一次调用 include_role 时通知 foo_handler。此外，主机 bar（由于 when 限制了所有其他主机）在第二次调用 include_role 时再次通知 foo_handler。

在 ansible-core 2.15 上，添加到 playbook 中的最后一个名为 foo_handler 的处理器来自第二次 include_role 调用，因此附加了 when: inventory_hostname == "bar"，导致处理器实际上仅在主机 bar 上运行并在所有其他主机上跳过。因此，来自主机 bar 的通知已去重。

在 ansible-core 2.14 及更早版本上，第一次调用的 foo_handler 会在所有主机上运行。此外，第二次调用的 foo_handler 会在主机 bar 上再次运行。

命令行 

ansible-galaxy search 的返回代码现在为 0 而不是 1，当结果为空时标准输出为空，以与其他 ansible-galaxy 命令保持一致。

已弃用 

向 vars: 提供字典列表已弃用，建议使用提供字典的方式。

而不是
```
vars:
  - var1: foo
  - var2: bar
```
使用
```
vars:
  var1: foo
  var2: bar
```

模块 

无重大更改

已移除的模块 

以下模块不再存在

无重大更改

Ansible-core 2.15 移植指南 

Playbook 

处理器 

命令行 

已弃用 

模块 

已移除的模块 

弃用通知 

值得注意的模块更改 

插件 

移植自定义脚本 

网络 