多主机配置全部完成后单主机执行最终任务的Ansible Playbook方案

这场景我太熟了，之前帮团队部署集群的时候刚好遇到过一模一样的需求，给你两个靠谱的Ansible Playbook解决方案，都是经过实战验证的：

这是最直接的方案，完美匹配你的要求：先让所有主机完成各自的配置任务，只有当所有主机配置都成功后，才在指定的某一台主机上执行最终任务。

直接上Playbook示例：

- name: 批量配置所有目标主机
  hosts: all
  # 所有主机的独立配置任务都放在这里
  tasks:
    - name: 安装必备依赖包
      apt:
        name: ["nginx", "python3"]
        state: present
      # 每台主机都会执行这个安装任务

    - name: 部署自定义配置文件
      template:
        src: ./templates/nginx.conf.j2
        dest: /etc/nginx/nginx.conf
      notify: 重启nginx服务

  handlers:
    - name: 重启nginx服务
      service:
        name: nginx
        state: restarted

  # 核心：post_tasks会在所有主机的tasks/handlers都执行完成后才触发
  post_tasks:
    - name: 仅在指定主机（比如host-01）执行最终任务
      shell: |
        # 这里写你的最终任务逻辑，比如注册服务、同步数据等
        echo "所有主机配置完成，开始执行最终初始化"
        /usr/local/bin/final_setup.sh
      # 指定任务执行的目标主机
      delegate_to: host-01
      # 确保这个任务只执行一次，不管有多少台主机
      run_once: true

为什么这个方案可行？ #

• post_tasks是Ansible的内置特性，会在当前Play的所有主任务、handler都执行完毕后才运行，只要任何一台主机的配置任务失败，整个Play就会终止，不会触发post_tasks，刚好满足"全部配置成功后才执行最终任务"的要求。
• run_once: true确保最终任务只跑一次，delegate_to明确指定任务在你想要的那台主机上执行，不会在所有主机重复跑。

如果你的场景需要更严谨——比如不仅要确认配置任务执行成功，还要验证所有主机的服务确实正常运行，再执行最终任务，可以在post_tasks里加一步全主机状态检查：

- name: 批量配置所有目标主机
  hosts: all
  tasks:
    # 这里和方案1的配置任务完全一样
    - name: 安装必备依赖包
      apt:
        name: ["nginx", "python3"]
        state: present

    - name: 部署自定义配置文件
      template:
        src: ./templates/nginx.conf.j2
        dest: /etc/nginx/nginx.conf
      notify: 重启nginx服务

  handlers:
    - name: 重启nginx服务
      service:
        name: nginx
        state: restarted

  post_tasks:
    - name: 检查所有主机的nginx服务是否正常响应
      uri:
        url: http://{{ target_host }}
        status_code: 200
      # 在控制节点执行检查（避免在目标主机额外安装依赖）
      delegate_to: localhost
      # 遍历所有目标主机，逐个检查
      loop: "{{ groups['all'] }}"
      loop_control:
        loop_var: target_host
      # 如果任何一台主机检查失败，Play终止，不执行后续任务
      failed_when: false
      register: check_result
      until: check_result.status == 200
      retries: 5
      delay: 10

    - name: 确认所有主机检查通过
      assert:
        that:
          - item.status == 200
        fail_msg: "部分主机服务未正常启动，终止最终任务"
      loop: "{{ check_result.results }}"

    - name: 仅在host-01执行最终任务
      shell: /usr/local/bin/final_setup.sh
      delegate_to: host-01
      run_once: true

这个方案多了一层服务可用性检查，适合生产环境的严谨部署场景，确保所有主机都处于正常状态后再执行最终的收尾任务。

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