主备集群下如何按先备后主顺序运行Ansible Playbook

问题核心根因 #

你遇到的“所有节点无论实际主备身份如何，都被同时加入两个临时主机组”的问题，和serial参数调整、inventory配置无关，是Ansible执行流程和变量作用域特性导致的典型坑点：

• 即便配置了serial: 1让节点逐台执行，只要没有把采集到的主备状态通过set_fact绑定为每台节点专属的私有fact，仅靠task级别的register全局变量存储脚本输出，变量会以play全局作用域在所有主机间共享——某一台节点刚采集到的状态值，会被整个play上下文里的所有其他主机读取到。
• 你之前在采集流程中直接穿插add_host任务的写法，会触发Ansible的内置执行逻辑：每个task在执行时，会对当前play下所有加载到内存的主机做一次when条件判断，不会只对当前串行执行的那台节点生效。这就会导致：第一台节点是primary时，所有主机读到这个primary的全局值，全部满足加入temp_primary的条件；等第二台节点采集到secondary状态，全局变量被更新为secondary，所有主机又全部满足加入temp_secondary的条件，最终所有节点都会同时出现在两个临时组里，后续变更自然就并行执行了。

可落地的动态执行方案 #

整个流程严格按照“全节点串行采集状态→固化节点私有fact→基于真实身份拆分临时组→按备先主后的顺序执行变更”的逻辑设计，完全规避变量污染问题：

第一步：全节点串行采集主备身份，固化为节点私有fact #

这一步的核心是彻底关闭跨节点变量共享，确保每台节点只存储自己的主备状态

• 针对QA_01_CLUSTER组启动第一个独立play，配置两个关键执行参数：
  • serial: 1：完全逐台串行执行，绝对不并行采集
  • gather_facts: no：不需要采集系统基础信息时可直接关闭，减少不必要的变量污染
• 逐台节点执行状态检查脚本，采集到的主备状态必须通过set_fact模块绑定为当前节点的私有fact，不能仅依赖register存储全局变量：

  - name: 串行采集所有节点的主备身份
    hosts: QA_01_CLUSTER
    serial: 1
    gather_facts: no
    tasks:
      - name: 执行本地状态检查脚本
        ansible.builtin.command: /tmp/status.sh
        register: node_status_raw
        changed_when: false
  
      - name: 将主备身份固化为当前节点的私有fact
        ansible.builtin.set_fact:
          node_role: "{{ node_status_raw.stdout | trim }}"
  

  这里的关键是用set_fact把状态值绑定到当前执行节点的fact存储区，后续所有判断都读取节点自己存的值，从根源上避免跨节点的变量串台。

第二步：基于私有fact动态拆分临时主机组 #

这一步不需要在远端节点执行任何实际操作，仅在控制节点读取已经固化的节点fact，完成临时组的拆分：

• 单独启动一个独立play，遍历QA集群的所有节点，根据每台节点自己存的node_role值，通过add_host加到对应的临时组里：

  - name: 根据主备身份拆分临时主机组
    hosts: QA_01_CLUSTER
    gather_facts: no
    tasks:
      - name: 将主节点加入临时主组
        ansible.builtin.add_host:
          name: "{{ inventory_hostname }}"
          group: temp_primary
        when: node_role == "primary"
  
      - name: 将备节点加入临时备组
        ansible.builtin.add_host:
          name: "{{ inventory_hostname }}"
          group: temp_secondary
        when: node_role == "secondary"
  

  因为这里的判断条件读取的是每个节点自己的私有fact，不会出现跨节点的值污染，每台节点只会根据自己的真实身份进对应的组，绝对不会出现同时进入两个组的问题。

第三步：严格按照备节点先、主节点后的顺序执行变更 #

用两个完全独立的play分别绑定对应的临时组，靠play的书写顺序控制执行流程，避免同play内的并行执行：

# 等所有备节点的身份识别完成后，先在备节点全量执行变更
- name: 备节点优先执行变更脚本
  hosts: temp_secondary
  gather_facts: no
  tasks:
    - name: 执行变更逻辑
      ansible.builtin.command: /tmp/testthis.sh

# 等备节点的变更全部完成、校验通过后，再在主节点执行相同操作
- name: 主节点最后执行变更脚本
  hosts: temp_primary
  gather_facts: no
  tasks:
    - name: 执行变更逻辑
      ansible.builtin.command: /tmp/testthis.sh

关键避坑点 #

• 绝对不要在同一个play里穿插采集任务和add_host任务，必须等所有节点的状态fact全部采集、固化完成后，再单独启动独立play做主机组拆分，完全规避“task遍历全主机判断when、全局变量污染”的问题。
• 不要依赖task级别的register全局变量做主备判断，必须通过set_fact把节点身份绑定到对应主机的私有fact上。
• 两个执行变更的play要完全独立，不要把两个临时组写在同一个play的hosts字段里，独立play的顺序执行逻辑是最稳定、最符合HA变更要求的执行方式。

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