Ansible：如何在端口连接成功后终止IP遍历循环？

需求说明 #

检查指定IP段内的目标端口连通性，找到第一个能够成功连接的IP:Port后立即终止循环，继续执行后续任务。

原代码问题 #

原代码使用until关键字是针对单个任务的重试逻辑，无法终止整个IP列表的循环迭代；同时IP列表解析错误，stdout_lines[0]会把字符串形式的列表拆分为单个字符作为循环项，导致逻辑错误。

修改后的代码 #

- name: Check connectivity
  hosts: all
  gather_facts: no

  vars:
    ip_range: "127.0.0.1/25"
    log_file: "ip_log.json"
    check_port: 25
    found_success: false  # 标记是否找到第一个连通的IP

  tasks:
    - name: Create IP List
      shell: python3 -c "import netaddr; print([str(ip) for ip in netaddr.IPNetwork('{{ ip_range }}')])"
      register: list_ip

    - name: Test connectivity to each IP
      wait_for:
        host: "{{ item }}"
        port: "{{ check_port }}"
        timeout: 1
        state: started
      loop: "{{ list_ip.stdout | from_json }}"  # 解析JSON格式的IP列表
      register: result_item
      failed_when: false  # 连接失败时不标记任务失败
      changed_when: false
      when: not found_success  # 未找到连通IP时才继续循环
      set_fact:
        found_success: true
        successful_ip_port: "{{ item }}:{{ check_port }}"  # 记录成功的IP:Port
      when: result_item is succeeded
      loop_control:
        label: "{{ item }}"  # 简化循环输出，只显示IP

    - name: Save connectivity results to log
      lineinfile:
        path: "{{ log_file }}"
        line: "{{ item.item }}:{{ check_port }} - {{ not item.succeeded }}"  # 失败状态取反，对应原逻辑的failed字段
        create: true  # 日志文件不存在时自动创建
      with_items: "{{ result_item.results }}"
      when: not found_success | default(false) or item.succeeded  # 只记录到第一个成功的IP为止的结果

关键修改点 #

• IP列表正确解析：使用from_json将shell输出的字符串列表转换为Ansible可识别的列表对象，避免循环项被拆分为单个字符。
• 设置连通标记：初始化found_success变量，当找到第一个连通的IP时，将其设为true，后续循环通过when: not found_success跳过执行。
• 任务失败控制：添加failed_when: false，确保单个IP连接失败不会终止整个Playbook执行。
• 结果日志优化：日志记录只保留到第一个成功IP为止的结果，避免冗余记录；同时自动创建日志文件。

补充说明 #

如果需要在找到成功IP后直接跳过后续所有任务（而非仅终止循环），可以在测试任务后添加条件判断：

- name: Exit play if successful IP found
  meta: end_play
  when: found_success

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