5.2. Puma 调优


puma 是一个 ruby 应用程序服务器,用于为客户端提供 Foreman 相关请求。对于任何应该处理大量客户端或频繁操作的 Satellite 配置,务必要相应地调整 Puma。

5.2.1. puma 线程

要配置 Puma 线程数量(per Puma worker),请使用这些值: threads_minthreads_max

threads_min 的值决定了每个 worker 启动时每个 worker 生成的线程数量。然后,当需要并发请求以及更多线程时,worker 将生成更多和更多的 worker,最多为 threads_max 限制。

我们建议将 threads_min 设置为与 threads_max 的值相同,因为 Puma 线程会导致 Satellite 服务器上的内存使用量更高。

例如,我们使用并发注册测试将两个设置在虚拟机上与 8 个 CPU 和 40 GiB RAM 进行对比。它们都使用了 --foreman-foreman-service-puma-threads-max=16--foreman-foreman-service-puma-workers=2。使用 --foreman-foreman-service-puma-threads-min=16 将最小 Puma 线程设置为 16 将会产生大约 12% 的内存用量,与 0 相比。

5.2.2. puma worker 和线程自动调整

如果您没有使用 satellite-installer 提供任何 Puma worker 和 thread 值,或者 Satellite 配置中没有它们,satellite-installer 会配置均衡的 worker 数量。它遵循以下公式:

min(CPU_COUNT * 1.5, RAM_IN_GB - 1.5)

在大多数情况下,这应该是正常的,但对于一些使用模式调整,则需要限制专用于 Puma 的资源量(因此其他 Satellite 组件可以使用这些)或出于其他原因而需要。每个 Puma worker 消耗大约 1 GiB RAM。

查看您当前的 Satellite 服务器设置

# cat /etc/systemd/system/foreman.service.d/installer.conf

查看当前活跃的 Puma worker

# systemctl status foreman

5.2.3. 手动调整 Puma worker 和线程计数

如果您决定不依赖 第 5.2.2 节 “puma worker 和线程自动调整”,您可以为这些可调项应用自定义数字。在以下示例中,我们使用 2 个 worker、5 和 5 个线程:

# satellite-installer \
--foreman-foreman-service-puma-workers=2 \
--foreman-foreman-service-puma-threads-min=5 \
--foreman-foreman-service-puma-threads-max=5

将您的更改应用到 Satellite 服务器。如需更多信息,请参阅 第 5.1 节 “应用配置”

5.2.4. Puma worker 和线程建议

要为不同的调优配置文件推荐线程和 worker 配置,我们使用不同的调优配置文件在 Satellite 上对 Puma 调优测试进行了 Puma 调优测试。此测试中使用的主要测试是与以下组合进行并发注册,以及不同的 worker 和线程数量。我们的建议基于并发注册性能,因此可能无法反映您的确切用例。例如,如果您的设置非常面向许多发布和推广的内容,您可能需要限制 Puma 使用的资源,而使用 Pulp 和 PostgreSQL。

Expand
Name主机数量RAM内核为 min 和 max 推荐的 Puma Threads推荐的 Puma Workers

default

0 – 5000

20 GiB

4

16

4 – 6

5000 – 10000

32 GiB

8

16

8 – 12

Large

10000 – 20000

64 GiB

16

16

12 – 18

extra-large

20000 – 60000

128 GiB

32

16

16 – 24

extra-extra-large

60000+

256 GiB+

48+

16

20 – 26

此处,调整 worker 数量是更重要的方面,在有些情况下,我们已达到 52% 的性能增加。虽然安装程序默认使用 5 分钟/最大线程,但我们推荐使用上表中所有调节配置文件的 16 个线程。这是因为,与设置 4 个线程相比,我们看到了高达 23% 的线程性能增加 16 个线程(14% 为 8,14% 为 32)的性能。

要找出这些建议,我们使用了并发注册测试案例,这是一个非常具体的用例。在您的 Satellite 上可能会有所不同,它们可能具有更多均衡的用例(不仅仅是注册)。保持默认的 5 分钟/最大线程也是很好的选择。

这些是我们提出了以下建议的一些措施:

Expand
 4 个 worker、4 个线程4 个 worker、8 个线程4 个 worker、16 个线程4 个 worker, 32 个线程

改进

0%

14%

23%

10%

在默认设置(4 个 CPU)上使用 4 个都要高的 worker - 与 2 个 worker 相比,与 2 个 worker 相比,我们看到了 5 个 worker 的 25% 的性能,但与 2 个 worker 相比,其性能降低了 8 个 worker - 请参阅下表:

Expand
 2 个 worker、16 个线程4 个 worker、16 个线程6 个 worker、16 个线程8 个 worker、16 个线程

改进

0%

26%

22%

-8%

在介质设置(8 CPU)上使用 8wagon- swig12 worker - 请查看下表:

Expand
 2 个 worker、16 个线程4 个 worker、16 个线程8 个 worker、16 个线程12 个 worker、16 个线程16 个 worker, 16 个线程

改进

0%

51%

52%

52%

42%

在 32 个 CPU 设置(这已在 90 GiB RAM 机器上测试),内存被认为是系统启动交换的一个因素 - 正确的 extra-large 应该有 128 GiB,我们测试的注册并发级别有问题,因此我们无法推荐它。

Expand
 4 个 worker、16 个线程8 个 worker、16 个线程16 个 worker, 16 个线程24 个 worker, 16 个线程32 个 worker, 16 个线程48 个 worker、16 个线程

改进

0%

37%

44%

52%

失败太多

失败太多

5.2.5. 配置 Puma worker

如果您有足够的 CPU,添加更多 worker 会增加性能。例如,我们将 Satellite 设置与 8 和 16 个 CPU 进行比较:

Expand
表 5.1. 用于测试 worker 数量效果的 satellite-installer 选项
Satellite 虚拟机具有 8 个 CPU,40 GiB RAMSatellite 虚拟机具有 16 个 CPU,40 GiB RAM

--foreman-foreman-service-puma-threads-min=16

--foreman-foreman-service-puma-threads-min=16

--foreman-foreman-service-puma-threads-max=16

--foreman-foreman-service-puma-threads-max=16

--foreman-foreman-service-puma-workers={2|4|8|16}

--foreman-foreman-service-puma-workers={2|4|8|16}

在 8 个 CPU 设置中,将 worker 数量从 2 改为 16,将并发注册时间提高 36%。在 16 个 CPU 设置中,相同的更改会导致 55% 的改进。

添加更多 worker 可以帮助进行总注册并发 Satellite 可以处理。在我们的测量中,使用 2 个 worker 设置可以处理 480 个并发注册,但添加更多 worker 提高了这种情况。

5.2.6. 配置 Puma 线程

更多线程可以缩短并行注册主机的时间。例如,我们比较了这两个设置:

Expand
Satellite 虚拟机具有 8 个 CPU,40 GiB RAMSatellite 虚拟机具有 8 个 CPU,40 GiB RAM

--foreman-foreman-service-puma-threads-min=16

--foreman-foreman-service-puma-threads-min=8

--foreman-foreman-service-puma-threads-max=16

--foreman-foreman-service-puma-threads-max=8

--foreman-foreman-service-puma-workers=2

--foreman-foreman-service-puma-workers=4

使用更多 worker 和相同的线程总数会导致在高度并发注册场景中速度大约为 11%。此外,添加更多 worker 不会消耗更多 CPU 和 RAM,但会获得更高的性能。

5.2.7. 配置 Puma DB 池

$db_pool 的有效值自动设置为等于 $foreman::foreman_service_puma_threads_max。它是 $foreman::db_pool$foreman::foreman_service_puma_threads_max 的最大值,但默认值为 5,因此任何增加到最大线程都会以相同的数量增加数据库连接池。

如果您遇到 ActiveRecord::ConnectionTimeoutError: 无法从 5.000 秒内从池中获取连接(等待 5.006 秒);所有池的连接都在 /var/log/foreman/production.log 中使用 错误。

查看当前的 db_pool 设置

# grep pool /etc/foreman/database.yml
  pool: 5

5.2.8. 手动调整 db_pool

如果您决定不依赖自动配置的值,您可以应用自定义号,如下所示:

# satellite-installer --foreman-db-pool 10

将您的更改应用到 Satellite 服务器。如需更多信息,请参阅 第 5.1 节 “应用配置”

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部