Ansible：不使用ignore_unreachable，遇不可达主机如何成功退出？

要解决不可达主机导致Playbook返回退出码4，同时保证reachable组仅包含可达主机的问题，可以通过分阶段检测可达性+清除主机错误状态的方式实现，无需依赖ignore_unreachable: true：

优化后的Playbook #

---
- hosts: all
  gather_facts: no
  tasks:
    # 1. 检测主机可达性，捕获结果且不中止任务
    - name: 检测主机是否可达
      ansible.builtin.ping:
      register: ping_result
      ignore_errors: yes

    # 2. 清除所有主机的错误状态，避免最终返回退出码4
    - name: 清除主机错误标记
      ansible.builtin.meta: clear_host_errors
      run_once: yes

    # 3. 筛选所有可达主机，提取主机名列表
    - name: 生成可达主机列表
      ansible.builtin.set_fact:
        reachable_hosts: "{{ ansible_play_hosts | map('extract', hostvars) | selectattr('ping_result.success', 'equalto', true) | map(attribute='inventory_hostname') | list }}"
      delegate_to: localhost
      run_once: yes

    # 4. 将首个可达主机加入reachable组
    - name: 添加首个可达主机到reachable组
      ansible.builtin.add_host:
        name: "{{ reachable_hosts | first }}"
        groups: reachable
      when: reachable_hosts | length > 0
      run_once: yes

# 针对reachable组执行后续操作（示例）
- hosts: reachable
  gather_facts: yes
  tasks:
    - name: 输出可达主机信息
      ansible.builtin.debug:
        msg: "当前选中的首个可达主机: {{ inventory_hostname }}"

关键逻辑说明 #

1. 精准检测可达性：使用ping模块直接检测主机连通性，比依赖gather_facts更可靠（gather_facts失败可能存在网络以外的原因），通过register捕获每个主机的检测结果。
2. 避免退出码异常：meta: clear_host_errors会清除所有主机的错误状态，让Ansible忽略之前的不可达错误，最终返回退出码0。
3. 严格筛选可达主机：通过selectattr('ping_result.success', 'equalto', true)仅保留检测成功的主机，确保reachable组中只有真正可达的主机。
4. 容错处理：添加when: reachable_hosts | length > 0避免无可达主机时触发错误。

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