验证任务：检查模式和差异模式

Ansible 提供两种用于验证任务的执行模式：检查模式和差异模式。这些模式可以单独或一起使用。当您创建或编辑剧本或角色时，它们非常有用，因为您可以知道它将做什么。在检查模式下，Ansible 运行不会对远程系统进行任何更改。支持检查模式的模块会报告它们本来要进行的更改。不支持检查模式的模块不会报告任何内容，也不会做任何事情。在差异模式下，Ansible 提供前后比较。支持差异模式的模块将显示详细的信息。您可以结合使用检查模式和差异模式，对您的剧本或角色进行详细的验证。

使用检查模式

检查模式只是一个模拟。它不会为使用 基于已注册变量的条件（先前任务的结果）的任务生成输出。但是，它非常适合验证一次在一个节点上运行的配置管理剧本。要以检查模式运行剧本

ansible-playbook foo.yml --check

在任务中强制或阻止检查模式

在版本 2.2 中新增。

如果您希望某些任务始终在检查模式下运行，或者从不运行，无论您是否使用 --check 运行剧本，您都可以将 check_mode 选项添加到这些任务中

  • 要强制任务在检查模式下运行，即使剧本是在没有 --check 的情况下调用的，请设置 check_mode: true。

  • 要强制任务在正常模式下运行并对系统进行更改，即使剧本是在使用 --check 的情况下调用的，请设置 check_mode: false。

例如

tasks:
  - name: This task will always make changes to the system
    ansible.builtin.command: /something/to/run --even-in-check-mode
    check_mode: false

  - name: This task will never make changes to the system
    ansible.builtin.lineinfile:
      line: "important config"
      dest: /path/to/myconfig.conf
      state: present
    check_mode: true
    register: changes_to_important_config

使用 check_mode: true 运行单个任务对于测试 Ansible 模块很有用，无论是测试模块本身还是测试模块进行更改的条件。您可以在这些任务上注册变量（参见 条件），以获取有关潜在更改的更多详细信息。

注意

在版本 2.2 之前，只有相当于 check_mode: false 的内容存在。它的表示法是 always_run: true。

在检查模式下跳过任务或忽略错误

在版本 2.1 中新增。

如果您希望在以检查模式运行 Ansible 时跳过任务或忽略任务上的错误，可以使用布尔魔术变量 ansible_check_mode，当 Ansible 以检查模式运行时，该变量设置为 True。例如

tasks:

  - name: This task will be skipped in check mode
    ansible.builtin.git:
      repo: ssh://[email protected]/mylogin/hello.git
      dest: /home/mylogin/hello
    when: not ansible_check_mode

  - name: This task will ignore errors in check mode
    ansible.builtin.git:
      repo: ssh://[email protected]/mylogin/hello.git
      dest: /home/mylogin/hello
    ignore_errors: "{{ ansible_check_mode }}"

使用差异模式

ansible-playbook 的 --diff 选项可以单独使用，也可以与 --check 一起使用。当您以差异模式运行时，任何支持差异模式的模块都会报告所做的更改，或者，如果与 --check 一起使用，则报告本来要进行的更改。差异模式在操作文件的模块中最为常见（例如，模板模块），但其他模块也可能显示“前后”信息（例如，用户模块）。

差异模式会产生大量的输出，因此最好在一次检查一个主机时使用它。例如

ansible-playbook foo.yml --check --diff --limit foo.example.com

在版本 2.4 中新增。

在任务中强制或阻止差异模式

由于 --diff 选项可能会泄露敏感信息，因此您可以通过指定 diff: false 为任务禁用它。例如

tasks:
  - name: This task will not report a diff when the file changes
    ansible.builtin.template:
      src: secret.conf.j2
      dest: /etc/secret.conf
      owner: root
      group: root
      mode: '0600'
    diff: false