ansible 使用 serial 参数控制批量变更节奏,通过指定分批执行的组数或百分比来限制并发主机数量。设置后,playbook 会按批次依次执行,前一批次全部成功后才进入下一批,从而实现灰度发布或降低风险的目的。

如何配置 serial 以限制并发主机数
在 Playbook 的 hosts 部分直接添加 serial 字段即可生效。该字段接受整数或百分比字符串。若设为整数,表示每批处理的主机数量;若设为百分比,表示总主机数的比例。默认值为 100%,即所有主机并行执行。

---
- name: Controlled Deployment
hosts: webservers
serial: 2
tasks:
- name: Update config
copy:
src: config.yml
dest: /etc/app/config.yml
notify: Restart service
handlers:
- name: Restart service
systemd:
name: myapp
state: restarted
上述配置中,serial: 2 表示每次只选择 2 台主机进行部署。假设目标主机列表有 10 台,则 Ansible 会分 5 个批次执行,每批 2 台。只有当第一批的 2 台主机任务全部成功(包括 handler 执行完毕)后,才会启动第二批。如果某台主机失败,整个 Play 将停止,不会继续后续批次,除非使用了 max_fail_percentage 或 ignore_errors。
如何使用百分比模式进行滚动更新
除了固定数量,还可以使用百分比来控制批次大小,这在主机数量动态变化时更为灵活。例如,设置 serial: '30%' 意味着每批处理总主机数的 30%。Ansible 会自动计算实际主机数并向上取整,确保至少有一台主机被选中。

---
- name: Percentage-based Rollout
hosts: database_servers
serial: '30%'
max_fail_percentage: 10
tasks:
- name: Apply schema change
mysql_db:
name: appdb
state: import
target: /tmp/schema.sql
在此示例中,serial: '30%' 结合 max_fail_percentage: 10 提供了更精细的控制。如果总共有 10 台数据库服务器,每批将处理 3 台(30%)。如果在任何一批中,失败的主机比例超过 10%,整个 Play 将中止。这种模式特别适用于对稳定性要求极高的场景,如数据库迁移,允许运维人员观察小批量变更的效果后再决定是否继续。
serial 模式下如何处理单台主机失败
当 serial 启用时,默认行为是“全有或全无”:只要当前批次中有任何一台主机任务失败,该批次即告失败,且整个 Play 立即终止,不再执行后续批次。这是为了防止错误扩散到更多主机。然而,在某些容错场景中,可能需要忽略个别主机的失败并继续后续批次。
要实现这一点,可以在任务级别使用 ignore_errors: yes,或者在 Play 级别使用 max_fail_percentage 配合 serial。例如,若设置 max_fail_percentage: 50,则允许当前批次中最多 50% 的主机失败而不中断整个 Play。但需注意,即使批次内部分主机失败,Ansible 仍会等待该批次所有剩余主机(无论成功或失败)完成后,再进入下一批次。这意味着失败的主机不会自动重试,除非显式配置了重试逻辑。此外,handler 的执行也受此影响:只有成功完成的任务对应的 handler 才会触发,失败任务的 handler 将被跳过。










