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

识别非幂等任务

识别非幂等任务

非幂等任务最常见的信号是:同一份 Playbook 在目标状态已经满足后再次执行,仍持续出现 changed。本课用重复执行定位这种任务,并判断它究竟真的反复修改了系统,还是仅仅因为模块无法判断状态而产生变更误报。

学习目标

  • 用连续两次执行和 recap 中的 changed 数量发现可疑任务
  • 区分“实际每次都改动”与“状态没变但被报告为 changed”
  • 用幂等模块、条件参数或 changed_when 修正任务并完成复验

用第二次执行暴露问题

幂等性的判断对象不是“任务有没有成功”,而是“目标已经达到后再次执行,是否还会产生不必要的状态变化”。第一次部署通常会有大量 changed;真正有诊断价值的是紧接着执行完全相同的第二次。

下面的实验故意使用 shell 重写同一份配置。文件内容第二次并没有变化,但 Ansible 无法从任意 Shell 命令推断最终状态,因此每次都会把该任务报告为 changed。

yaml
# 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 只需要本机目标:

ini
# inventory.ini
localhost ansible_connection=local

连续执行两次:

bash
ansible-playbook -i inventory.ini idempotence.yml
ansible-playbook -i inventory.ini idempotence.yml

预期输出中,第二次执行仍会看到写配置任务为 changed;这里只保留 recap,实际任务日志会更长:

text
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 它不会改变状态。

yaml
# 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

从空目录开始连续执行两次:

bash
rm -rf /tmp/ansible-idempotence-demo
ansible-playbook -i inventory.ini idempotence-fixed.yml
ansible-playbook -i inventory.ini idempotence-fixed.yml

预期输出的关键是第二次 changed=0:

text
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,并且目标状态保持正确,才说明这项幂等性问题真正关闭。

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

目录与阅读设置

阅读设置

17

记录一个想法

识别非幂等任务

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

登录哪都通