基础设施即代码 / 系统课时
用 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 之外执行,只用于制造“预演前状态”。
mkdir -p /tmp/anystack-check
printf 'mode=legacy\nworkers=2\n' > /tmp/anystack-check/app.conf
rm -f /tmp/anystack-check/command.log预期输出为空;文件内容可直接验证。
<NO_OUTPUT>使用下面的 Inventory:
[demo]
localhost ansible_connection=localPlaybook 同时包含一个支持 Check/Diff 的 copy 任务和一个普通 command 任务。后者没有提供 creates 或 removes 条件,因此在检查模式下无法可靠预测执行结果。
# 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现在执行预演,并在结束后检查磁盘上的真实状态。
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。真正的配置文件仍保持旧内容,命令日志也不存在。
--- before
+++ after
@@
-mode=legacy
-workers=2
+mode=safe
+workers=4
...
mode=legacy
workers=2
command not executed从预演结果判断风险
看到 changed 不代表机器已经改变,它只表示模块预测正常执行时会改变。看到 ok 通常表示当前状态已满足目标。更需要警惕的是 skipped:在检查模式中,它可能意味着条件不成立,也可能意味着模块无法模拟;必须结合任务类型和日志判断,不能把“没有 changed”直接等同于“上线无风险”。
确认差异符合预期后,再去掉 --check 进行真实执行。
ansible-playbook -i inventory.ini check-demo.yml --diff
cat /tmp/anystack-check/app.conf
cat /tmp/anystack-check/command.log预期结果是文件真正变为新配置,并出现命令执行标记。
...
mode=safe
workers=4
invoked处理 Check Mode 的边界
某些任务需要在预演时仍真实执行,例如只读查询,可在任务级设置 check_mode: false;相反,check_mode: true 可以强制某个支持检查模式的任务按预演方式运行。是否处于检查模式还可以通过 ansible_check_mode 条件判断,但不要用它大面积跳过关键逻辑,否则预演结果会越来越失真。
Check/Diff 最可靠的用法是“先发现明显差异,再验证模块边界”。预演通过后仍应按正常变更流程执行测试、分批发布和结果验证,因为外部系统状态、命令副作用和运行时条件不一定能被检查模式完整模拟。