基础设施即代码 / 系统课时
识别非幂等任务
识别非幂等任务
非幂等任务最常见的信号是:同一份 Playbook 在目标状态已经满足后再次执行,仍持续出现 changed。本课用重复执行定位这种任务,并判断它究竟真的反复修改了系统,还是仅仅因为模块无法判断状态而产生变更误报。
学习目标
- 用连续两次执行和 recap 中的
changed数量发现可疑任务 - 区分“实际每次都改动”与“状态没变但被报告为 changed”
- 用幂等模块、条件参数或
changed_when修正任务并完成复验
用第二次执行暴露问题
幂等性的判断对象不是“任务有没有成功”,而是“目标已经达到后再次执行,是否还会产生不必要的状态变化”。第一次部署通常会有大量 changed;真正有诊断价值的是紧接着执行完全相同的第二次。
下面的实验故意使用 shell 重写同一份配置。文件内容第二次并没有变化,但 Ansible 无法从任意 Shell 命令推断最终状态,因此每次都会把该任务报告为 changed。
# idempotence.yml
- name: Demonstrate a changed false positive
hosts: localhost
connection: local
gather_facts: false
tasks:
- name: Ensure demo directory exists
ansible.builtin.file:
path: /tmp/ansible-idempotence-demo
state: directory
mode: "0755"
- name: Write desired config through shell
ansible.builtin.shell: |
printf '%s\n' 'mode=production' > /tmp/ansible-idempotence-demo/app.conf配套 Inventory 只需要本机目标:
# inventory.ini
localhost ansible_connection=local连续执行两次:
ansible-playbook -i inventory.ini idempotence.yml
ansible-playbook -i inventory.ini idempotence.yml预期输出中,第二次执行仍会看到写配置任务为 changed;这里只保留 recap,实际任务日志会更长:
PLAY RECAP
localhost : ok=2 changed=2 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
PLAY RECAP
localhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0如果第二次仍有 changed,先定位具体任务,再判断它是否真的修改了文件、服务、包或远端对象。只有确认变化来源,才能决定是改模块还是改状态判断。

区分真实变更和变更误报
持续 changed 有两类根因。第一类是真实非幂等:例如每次都追加一行、生成新时间戳、无条件重启服务或创建随机名称资源。系统状态确实不断变化,应改写任务本身。
第二类是变更误报:任务只是执行了一个无法自动判断状态的命令,最终系统状态其实没有变化。此时问题在 Ansible 的状态判断,不一定在被管理对象。
排查时不要只看 recap。可同时比较文件校验和、服务启动时间、资源数量或模块返回值,确认第二次执行前后是否真的不同。
优先让模块表达目标状态
能用声明式模块时,不要用 shell 或 command 模拟“确保某状态存在”。把上面的任务改成 copy 后,模块会比较目标文件内容与属性;读操作则用 changed_when: false 明确告诉 Ansible 它不会改变状态。
# idempotence-fixed.yml
- name: Verify an idempotent implementation
hosts: localhost
connection: local
gather_facts: false
tasks:
- name: Ensure demo directory exists
ansible.builtin.file:
path: /tmp/ansible-idempotence-demo
state: directory
mode: "0755"
- name: Ensure config has the desired content
ansible.builtin.copy:
dest: /tmp/ansible-idempotence-demo/app.conf
content: "mode=production\n"
mode: "0644"
- name: Read config without reporting a change
ansible.builtin.command:
argv:
- cat
- /tmp/ansible-idempotence-demo/app.conf
register: config_read
changed_when: false从空目录开始连续执行两次:
rm -rf /tmp/ansible-idempotence-demo
ansible-playbook -i inventory.ini idempotence-fixed.yml
ansible-playbook -i inventory.ini idempotence-fixed.yml预期输出的关键是第二次 changed=0:
PLAY RECAP
localhost : ok=3 changed=2 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
PLAY RECAP
localhost : ok=3 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0实际路径和 Ansible 输出中的耗时可能不同,但第二次执行不应再产生变更。
不要用 changed_when 掩盖真实修改
changed_when: false 只适合读取、探测或已经有可靠外部条件证明“没有改变系统”的任务。若命令每次都写文件、重启服务或修改资源,却强行标记为未变化,会让 recap 失真,还可能阻止依赖 notify 的 Handler 被触发。
当命令无法替换时,应优先使用模块自带的 creates、removes 等条件,或根据明确返回值编写 changed_when。完成修复后,再做一次连续双跑;第二次 changed=0,并且目标状态保持正确,才说明这项幂等性问题真正关闭。