如何让Ansible debug模块仅显示一次消息，不受主机数量影响

方法一：使用bypass_host_loop选项 #

这个选项是Ansible 2.11及以上版本新增的，作用是让任务跳过主机循环，直接只执行一次，完美解决多主机重复输出的问题。示例代码如下：

- name: 输出单次调试信息
  debug:
    msg: "这条调试消息只会显示一次"
    bypass_host_loop: true

方法二：使用run_once参数 #

如果你的Ansible版本低于2.11，或者想兼容更多版本，run_once是更通用的选择。它会强制任务只在第一个匹配的目标主机上执行一次，从而让调试信息仅输出一次：

- name: 输出单次调试信息
  debug:
    msg: "这条调试消息只会显示一次"
  run_once: true

方法三：委托到本地主机配合run_once #

如果需要确保调试任务在本地执行且仅运行一次，可以结合delegate_to和run_once：

- name: 输出单次调试信息
  debug:
    msg: "这条调试消息只会显示一次"
  delegate_to: localhost
  run_once: true

总结：如果你的Ansible版本满足要求，优先用bypass_host_loop，它是专门为跳过主机循环设计的；版本不够的话，run_once足够解决问题，写法也更简洁。

内容的提问来源于stack exchange，提问作者Tux212