跳转到内容
安装

性能

三个实测的工作负载、背后的配置、复现它们的命令,以及剩余的时间花在了哪里。

Volant 在三个真实的工作负载上做了测量,每个都由仓库中的一个 recipe 运行。本页的每个数字都来自这些 recipe。

在已经收敛的两台 Ubuntu 24.04 主机上,应用四个 Ansible Galaxy role(geerlingguy.security、nginx、git 和 pip),Volant 用 0.529 秒完成,而启用 pipelining = True 的 ansible-core 2.19.12 需要 26.435 秒,比值为 49.97。在官方 k3s-ansible 的 site.yml 上,针对已安装的集群,Volant 用 23.477 秒,参照版本用 50.519 秒,比值为 2.15。测量日期为 2026-09-27,使用 just bench 和 just bench-k3s,它们可以复现这些数字。此后没有重新测量过。第三个工作负载是对一个 Galaxy role 完整运行 molecule test,见 Molecule。

两个工作负载,两台已收敛的主机三次计时运行的中位数,2026-09-27。参照版本:ansible-core 2.19.12,pipelining = True。越短越快。
  • ansible-core 2.19.12
  • Volant
  • 四个 Galaxy role26.435 s0.529 s四个 Galaxy roleansible-core 2.19.12: 26.435 sVolant: 0.529 s
  • k3s-ansible site.yml50.519 s23.477 sk3s-ansible site.ymlansible-core 2.19.12: 50.519 sVolant: 23.477 s
Show as a table
ansible-core 2.19.12Volant
四个 Galaxy role26.435 s0.529 s
k3s-ansible site.yml50.519 s23.477 s

两个比值相差很大,是因为这些 role 在已收敛的主机上什么也不改变,参照版本在那里的大部分时间花在每个模块周围的机制上,而 Volant 去掉了其中的大部分。k3s playbook 每次都会重启服务并运行安装脚本,这部分工作在任何一个引擎下耗时都一样。还剩下什么对此做了细分。

受管主机 两台 Ubuntu 24.04 主机,各 4 核,位于 overlay 网络中
控制节点 Ubuntu 26.04,8 核
Volant e57fbe5(v0.1.0-alpha.7-74-ge57fbe5)的发布构建,默认设置:开启原生模块,每台主机一个 ssh 连接,--facts auto,关闭批处理
参照版本 ansible-core 2.19.12,pipelining = True,forks 保持默认值 5,其他设置全部使用默认值
role 工作负载 geerlingguy.security 3.0.2、geerlingguy.nginx 3.3.1、geerlingguy.git 3.0.1 和 geerlingguy.pip 3.1.2 放在同一个 play 中,become: true,收集 facts,每台主机 56 个 task
k3s 工作负载 固定提交的 k3s-ansible playbook,k3s v1.31.12+k3s1,一台 server 和一台 agent,集群先由参照版本运行一遍来安装
运行次数 每个引擎先做一次不计时的预热运行,然后各做三次计时运行,报告中位数

每次计时运行的 PLAY RECAP 都会与第一次运行的对比,两个引擎之间也是如此。出现差异就意味着两个引擎做了不同的工作,recipe 会失败。在 role 工作负载上,每次运行每台主机都以 ok=28 changed=0 skipped=28 结束。在 k3s 上,每次运行 server 都以 ok=34 changed=2 skipped=69 结束,agent 以 ok=19 changed=3 skipped=54 结束。changed 的 task 就是还剩下什么中描述的实际工作。

各次运行的耗时:

工作负载 Volant(秒) ansible-core(秒)
四个 Galaxy role 0.530, 0.529, 0.524 26.408, 26.438, 26.435
k3s-ansible 24.150, 23.448, 23.477 51.121, 50.519, 50.505

两个 recipe 都以 release 模式构建 Volant,针对你指定的主机运行,并打印中位数和比值。控制节点需要用 uv tool install 安装 ansible-core 2.19.12,主机上的账户需要无密码的 sudo。

终端窗口
VOLANT_TARGET_HOST=host1 VOLANT_SECOND_HOST=host2 just bench 3
VOLANT_TARGET_HOST=host1 VOLANT_SECOND_HOST=host2 just bench-k3s 3

每次计时的 Volant 运行还会通过 VOLANT_PROFILE_JSON 把它的 profile 写到 target/bench/ 下,所以出人意料的数字可以追溯到引起它的 task。下面的表格来自这些文件。

时间按每台主机计,取自 2026-09-27 的中位数运行。同样的工作负载在 2026-09-24(原生模块出现之前)的测量中,role 用了 12.66 秒(参照版本 26.23 秒),k3s 用了 37.53 秒(参照版本 50.19 秒)。那一天的 profile 见决策记录 0008。

步骤 耗时
在控制节点上构建 Python 模块并集 15.3 ms,从缓存读取
apt,8 个 task,软件包已安装,缓存是新的 38.4 ms,原生
setup,收集 facts 47.6 ms,原生
systemd,3 个 task 52.4 ms,原生
file ×8、lineinfile ×8、stat ×5 52.8 ms,原生
打开连接 172.6 ms
在控制节点上准备 task 25.0 ms
传输中的帧和 blob 27.1 ms
在每个 task 上等待另一台主机 10.6 ms
总耗时,两台主机 0.529 秒(参照版本 26.435 秒)

中位数运行中的全部 66 个模块 task(每台主机 33 个)都由原生模块应答。没有一个被交还,所以两台主机上都没有启动 Python 服务进程。

两台主机不同的地方,数字取 server 的。

步骤 耗时
构建 Python 模块并集,包含 collection 30.6 ms,从缓存读取
重启 k3s 服务,server 和 agent 8,269 + 4,763 ms,原生 systemd
service_facts 2,485 ms,原生
package_facts 168 ms,原生
apt: name=policycoreutils update_cache=true 2,205 ms,交还给 Python
收集 facts 55 ms,原生
在控制节点上准备 task 185 ms
打开连接 350 ms
在每个 task 上等待另一台主机(agent) 253 ms
总耗时,两台主机 23.477 秒(参照版本 50.519 秒)

在中位数运行中,28 个 task 以原生方式运行,11 个被交还给 Python 模块,5 个运行的是没有原生版本的模块(ansible.posix.sysctl 和 wait_for)。

在 k3s 上,Volant 的 23.5 秒中大部分是 playbook 要求的工作:

  • k3s 服务的重启,server 上约 8.3 秒,agent 上约 4.8 秒,花在 systemctl 和 k3s 本身;
  • k3s 安装脚本,每台主机约 1.4 到 1.5 秒;
  • 13 个 command task,例如 k3s --version,两台主机合计约 3.1 秒。

两个引擎为这些付出的代价相同,因为它们是在主机上运行的进程。

有两个步骤受限于参照版本自身的做法:

  • service_facts 运行 ansible-core 运行的命令(systemctl list-unit-files、service --status-all,以及每个 unit 一次 systemctl show),以便让它的应答保持一致。原生模块并行运行这些命令,而参照版本逐个运行,但它们仍然占据了其 2.4 秒的大部分。只要读取同样的来源,它就无法低于这个水平。
  • playbook 的 apt task 设置了 update_cache 而没有 cache_valid_time,所以参照版本每次都运行 apt-get update。测量时,原生的 apt 只应答无事可做的 task,所以这个 task 交给了 Python 模块,缓存刷新占了它 2.2 秒的大部分。自 2026-10-25 起,原生的 apt 自己执行更新(#879)。

这两个步骤合计每台主机耗时 4.5 到 4.7 秒。要让它们更快,就意味着读取参照版本之外的其他来源,这个决定留给以后的版本。

molecule test 运行一个 role 的整套测试流程:删除之前运行留下的容器,检查语法,创建容器,应用 role(converge),再应用一次以确认没有任何变化(idempotence),最后删除容器。Molecule 为其中每个 playbook 启动 ansible-playbook,所以只要把 Volant 的 ansible-playbook 放在 PATH 最前面,整套流程就在 Volant 下运行,role 和 Molecule 都不用改。

在 geerlingguy.nginx 上使用 docker 驱动,完整的 molecule test 在 Volant 下用 60.349 秒,在 ansible-core 2.19.12 下用 96.102 秒,比值为 1.59。两个引擎在每一轮中给出的 PLAY RECAP 行都相同。测量日期为 2026-11-08,使用 just bench-molecule 5。

geerlingguy.nginx 上的 molecule test,docker 驱动每个引擎五轮计时运行的中位数,2026-11-08。参照版本:ansible-core 2.19.12,使用 Molecule 写入的配置。越短越快。
  • ansible-core 2.19.12
  • Volant
  • Create9.750 s5.931 sCreateansible-core 2.19.12: 9.750 sVolant: 5.931 s
  • Converge51.650 s38.133 sConvergeansible-core 2.19.12: 51.650 sVolant: 38.133 s
  • Idempotence13.133 s3.320 sIdempotenceansible-core 2.19.12: 13.133 sVolant: 3.320 s
  • Destroy,两次15.801 s11.288 sDestroy,两次ansible-core 2.19.12: 15.801 sVolant: 11.288 s
  • 完整测试96.102 s60.349 s完整测试ansible-core 2.19.12: 96.102 sVolant: 60.349 s
Show as a table
ansible-core 2.19.12Volant
Create9.750 s5.931 s
Converge51.650 s38.133 s
Idempotence13.133 s3.320 s
Destroy,两次15.801 s11.288 s
完整测试96.102 s60.349 s
Role geerlingguy.nginx,commit 5ff0b23,其 default 场景:一个 Rocky Linux 9 容器,22 个 task
镜像 geerlingguy/docker-rockylinux9-ansible,按 digest 固定,在各轮运行之前拉取
Molecule Molecule 26.11.0、molecule-plugins 26.11.0 和 ansible-compat 26.11.0,装在 Python 3.12 虚拟环境中,另有 community.docker 4.8.5 和 ansible.posix 2.2.2
参照版本 同一虚拟环境中的 ansible-core 2.19.12,使用 Molecule 写入的 ansible.cfg(forks = 50),其他设置均为默认值
Volant da423e7(v0.1.0-alpha.13-265-gda423e78)的 release 构建,通过其 ansible-playbook 链接运行,设置 VOLANT_RUNTIME=system
机器 其他工作负载使用的同一台控制节点(Ubuntu 26.04,8 核),Docker 29.1.3 和容器也在这台机器上运行
系统负载 每轮计时运行前后的一分钟平均负载在 0.84 到 2.30 之间,两个引擎处于同一范围
运行轮次 每个引擎先运行一轮不计时的预热,然后两个引擎交替各运行五轮计时,报告中位数

每一轮开始时都没有容器,结束时也必须没有容器。每一轮中,converge 都以 ok=14 changed=8 skipped=8 结束,idempotence 都以 ok=12 changed=0 skipped=8 结束,两个引擎都是如此。

放在 PATH 最前面的一个小 ansible-playbook 为 Molecule 启动的每个 playbook 计时,两个引擎的计时方式相同,由此得到各步骤的拆分:

步骤 ansible-core(秒) Volant(秒)
创建容器 9.750 5.931
Converge 51.650 38.133
Idempotence 13.133 3.320
Destroy,开始时和结束时各一次 15.801 11.288
语法检查 0.749 0.027
Molecule 自身的工作 5.167 1.650
完整测试 96.102 60.349

每一行都是单独取的中位数,所以各行相加不等于最后一行。Molecule 自身的工作是完整测试去掉各 playbook 之后剩下的时间,其中包括 Molecule 发起的 ansible-playbook --version 调用,这些调用在被测引擎下运行。

完整测试的逐轮结果:

引擎 各轮(秒)
ansible-core 100.599、95.499、96.675、96.102、95.646
Volant 61.769、60.048、60.349、60.095、60.794

Volant 下剩余的时间大部分花在引擎之外:

  • Converge 用 dnf 安装 nginx,dnf 从 Rocky Linux 和 EPEL 的镜像站下载软件包。Idempotence 运行同样的 task,但没有东西要安装,只用 3.320 秒,所以 converge 的 38.133 秒大部分是软件包安装。这段时间取决于镜像站:参照版本的一轮不计时预热就因为一个 EPEL 镜像站没有响应而失败。
  • Docker 在 create 期间启动容器,在 destroy 期间停止并删除容器。引擎只是在等待它。
  • 在新机器上第一次运行 molecule test 时还要拉取镜像,大小为 268,904,562 字节。recipe 在计时运行之前就拉取了镜像,所以上面的数字不包括这次下载。下载要多久取决于你的网络。

有两处差异出现在日志中,而不在 recap 中。Volant 比 ansible-core 更早轮询 async_status,所以 destroy 在等待 docker 时可能多打印一行 FAILED - RETRYING。另外,Volant 的各轮运行设置了 VOLANT_RUNTIME=system:不设置时,隐式 localhost 会在 Volant 托管的 Python 下运行 docker 驱动的模块,而这个 Python 没有 docker 库;ansible-core 则使用虚拟环境中的 Python(#1422)。

这个 recipe 需要运行它的机器上有 Docker 和 uv,不需要其他主机。它以 release 模式构建 Volant,在 target/molecule/ 下安装固定的版本,按 commit 获取 role,并按 digest 拉取镜像:

终端窗口
just bench-molecule 5

第一个参数是每个引擎的计时轮数。每轮开始前,recipe 会等到没有构建或其他 ansible-playbook 在运行,并且一分钟平均负载低于第二个参数(默认 1.5)。它把中位数和负载范围写到 target/molecule/logs/,如果两轮给出的 PLAY RECAP 行不同,或者某轮之前或之后存在名为 instance 的容器,就会失败。

决策记录 0008解释了这些数字背后的选择,以及测量过后被放弃的方案。