基础设施即代码 / 系统课时

用 Check 与 Diff 预演变更

用 Check 与 Diff 预演变更

在正式修改主机前,--check 可以让支持检查模式的模块预测“是否会变更”,--diff 则展示文件类任务的前后差异。两者合用能提前发现意外修改,但它们不是事务回滚,也无法替代对不支持检查模式任务的人工判断。

学习目标

  • 使用 --check --diff 预演 Playbook,并读懂 changed、skipped 与差异输出
  • 验证预演不会真正写入支持检查模式的文件任务
  • 识别不支持 Check Mode、强制执行和敏感 Diff 的边界

Check 与 Diff 分别回答什么

Check Mode 关注“如果现在执行,会不会产生变更”。支持该能力的模块不会真正落盘,而是返回预测状态,因此你仍可能看到 changed。Diff Mode 关注“变更前后具体差什么”,常见于 copy、template、lineinfile 等文件内容任务。

这两个开关相互独立:--check 不保证有差异文本,--diff 也不会阻止真实修改。生产预演通常同时启用,但必须继续查看任务是否出现 skipped、模块是否声明支持 Check Mode,以及 Playbook 是否包含外部 API、命令或其他不可预测副作用。

构造一次可验证的预演

先准备一个旧配置。这个步骤在 Playbook 之外执行,只用于制造“预演前状态”。

bash
mkdir -p /tmp/anystack-check
printf 'mode=legacy\nworkers=2\n' > /tmp/anystack-check/app.conf
rm -f /tmp/anystack-check/command.log

预期输出为空;文件内容可直接验证。

text
<NO_OUTPUT>

使用下面的 Inventory:

ini
[demo]
localhost ansible_connection=local

Playbook 同时包含一个支持 Check/Diff 的 copy 任务和一个普通 command 任务。后者没有提供 creates 或 removes 条件,因此在检查模式下无法可靠预测执行结果。

yaml
# check-demo.yml
- name: 演示 Check 与 Diff
  hosts: demo
  gather_facts: false
  tasks:
    - name: 更新应用配置
      ansible.builtin.copy:
        dest: /tmp/anystack-check/app.conf
        content: |
          mode=safe
          workers=4
        mode: "0644"

    - name: 记录一次命令执行
      ansible.builtin.command:
        cmd: /bin/sh -c 'echo invoked >> /tmp/anystack-check/command.log'
      changed_when: true

现在执行预演,并在结束后检查磁盘上的真实状态。

bash
ansible-playbook -i inventory.ini check-demo.yml --check --diff
cat /tmp/anystack-check/app.conf
test ! -e /tmp/anystack-check/command.log && echo "command not executed"

预期结果会看到配置任务的 unified diff,并把该任务预测为 changed;命令任务通常显示 skipped。真正的配置文件仍保持旧内容,命令日志也不存在。

text
--- before
+++ after
@@
-mode=legacy
-workers=2
+mode=safe
+workers=4
...
mode=legacy
workers=2
command not executed

从预演结果判断风险

看到 changed 不代表机器已经改变,它只表示模块预测正常执行时会改变。看到 ok 通常表示当前状态已满足目标。更需要警惕的是 skipped:在检查模式中,它可能意味着条件不成立,也可能意味着模块无法模拟;必须结合任务类型和日志判断,不能把“没有 changed”直接等同于“上线无风险”。

确认差异符合预期后,再去掉 --check 进行真实执行。

bash
ansible-playbook -i inventory.ini check-demo.yml --diff
cat /tmp/anystack-check/app.conf
cat /tmp/anystack-check/command.log

预期结果是文件真正变为新配置,并出现命令执行标记。

text
...
mode=safe
workers=4
invoked

处理 Check Mode 的边界

某些任务需要在预演时仍真实执行,例如只读查询,可在任务级设置 check_mode: false;相反,check_mode: true 可以强制某个支持检查模式的任务按预演方式运行。是否处于检查模式还可以通过 ansible_check_mode 条件判断,但不要用它大面积跳过关键逻辑,否则预演结果会越来越失真。

Check/Diff 最可靠的用法是“先发现明显差异,再验证模块边界”。预演通过后仍应按正常变更流程执行测试、分批发布和结果验证,因为外部系统状态、命令副作用和运行时条件不一定能被检查模式完整模拟。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Check 与 Diff 预演变更

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通