0Pricing
Ansible Academy · 课时

为什么 command 会破坏幂等性

了解原始 shell 的陷阱及规避方法

为什么 command 会破坏幂等性 是 CoddyKit 上的免费 Ansible Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Ansible Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Ansible Academy 课程共包含 4 节课。

command 始终运行

command 模块只会在主机上运行您提供的内容。它不知道“完成”是什么样子，因此每次都会运行。

ansible.builtin.command: useradd deploy

始终为 changed

由于 command 无法检查状态，Ansible 每次运行都会将其报告为changed，即使命令实际上没有产生任何新结果。

changed: [web1]

重复运行可能造成问题

更糟的是，有些命令在重复运行时会失败或重复执行工作，例如 useradd 会因为用户已经存在而报错。

优先使用基于状态的模块

处理用户时，请改用 user 模块。它会检查账户是否存在，仅在账户缺失时创建账户，从而保持幂等性。

ansible.builtin.user:
  name: deploy
  state: present

通常都有对应模块

大多数常见的 shell 任务都有专用的模块：file、copy、lineinfile 和 git。使用这些模块，Ansible 就能进行比较，并在状态正确时跳过任务。

用 creates 为 command 添加保护

如果必须使用 command，请添加 creates。当该路径已经存在时，Ansible 会跳过任务，从而恢复幂等性。

ansible.builtin.command: ./build.sh
args:
  creates: /opt/app/built

或用 removes 添加保护

creates 的对应选项是 removes：只有在指定路径仍然存在时，命令才会运行，适合用于清理步骤。

ansible.builtin.command: rm /tmp/lock
args:
  removes: /tmp/lock

用 when 控制 command

您也可以用注册检查的结果作为依据，将 command 包装在 when 条件中，使其仅在确实需要时运行。

告诉 Ansible 它没有进行更改

对于只读命令，请设置 changed_when: false，这样 Ansible 就不会在每次运行时都将其报告为 changed。

ansible.builtin.command: cat /etc/hostname
changed_when: false

shell 存在同样的问题

shell 模块也有这个缺陷。它通过 shell 运行命令，因此如果不采用同样的保护措施，它同样不具备幂等性。

将原始命令作为最后手段

原始 command 是应急手段，而不是默认选择。每个原始命令都可能让幂等性悄然失效，因此只有在没有合适模块时才使用它。

快速检查

您使用 command 运行构建脚本，但它在每次运行时都显示 changed。

回顾

command 和 shell 模块总会运行，并且总会报告 changed。请优先使用真正的模块，或用 creates、removes 或 changed_when 为它们添加保护。🛡️

常见问题解答

「为什么 command 会破坏幂等性」课时是免费的吗？

是的 — 「为什么 command 会破坏幂等性」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Ansible Academy 课程的其余内容，请升级到 CoddyKit PRO。 Ansible Academy 课程共包含 4 节课。

「为什么 command 会破坏幂等性」这节课中我会学到什么？

了解原始 shell 的陷阱及规避方法 你通过在浏览器中直接运行的动手代码来练习 Ansible Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Ansible Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Ansible Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。

「为什么 command 会破坏幂等性」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Ansible Academy 课中编写并运行代码吗？

能。每节 Ansible Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 期望状态，而非逐步脚本
  2. 阅读输出中的 changed 与 ok
  3. 为什么 command 会破坏幂等性
  4. 检查模式：使用 --check 进行试运行
← 返回 Ansible Academy