ansible任务实现幂等性的核心是使用专用模块、声明期望状态、结合facts条件控制和handlers解耦变更。例如：dnf模块设state: present自动跳过已安装包；copy模块显式设force: no避免覆盖；stat检查后用when控制执行；handlers仅在配置变更时触发service重启。

编写幂等性良好的 Ansible 任务，核心是避免“重复执行引发意外变更”，让同一任务运行一次或多次结果完全一致。这不靠运气，而靠正确使用模块、合理设计逻辑和规避常见陷阱。

优先用专用模块，别写 shell 命令

Ansible 大量内置模块（如 ansible.builtin.dnf、ansible.builtin.user、ansible.builtin.file）天生支持幂等性——它们会先检查目标状态，仅在不满足时才执行操作。

• ✅ 正确：用 dnf: name: nginx state: present —— 若已安装则跳过
• ❌ 错误：用 command: yum install -y nginx —— 每次都执行，可能触发重复安装、覆盖配置甚至报错
• ⚠️ 注意：shell 和 command 模块几乎都不幂等，除非你手动加判断逻辑（比如先 stat 查文件是否存在），但这样写复杂且易出错

明确声明期望状态，少依赖“当前”

幂等的关键是描述“最终该是什么样”，而不是“现在要做什么”。模块的 state 参数就是为此设计的。

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

• state: present 表示“确保存在”，适用于包、用户、文件等
• state: absent 表示“确保不存在”，用于清理场景
• state: latest 表示“确保是最新版”，适合安全更新
• 避免只写 copy 不带 force: no（默认 force: yes），否则每次都会覆盖；若只需首次部署，显式加 force: no

用 facts 和条件控制执行时机

有些操作天然不适合反复执行（如重启服务、初始化数据库），可通过 facts 收集信息后加 when 判断。

• 用 package_facts 获取已安装包列表，再决定是否安装特定版本
• 用 stat 检查关键配置文件是否已存在，避免覆盖人工修改
• 用 setup（或 gather_facts: yes）获取系统信息，按 OS 版本、架构等差异化执行
• 例如：只有当 ansible_distribution == "Rocky" 且 nginx_conf_exists.stat.exists == false 时，才部署默认配置

善用 handlers 管理服务变更

服务重启这类“副作用”操作必须与配置变更解耦，否则每次运行 Playbook 都会重启服务，破坏幂等性。

• 把配置文件变更任务设为 notify: restart nginx
• 在 handlers 区块定义 restart nginx，它只在被通知且实际发生变更时才触发
• handler 内部也应使用 service 模块（state: restarted），而非 shell: systemctl restart nginx