支持的平台和系统要求

Antora可在Linux、macOS和Windows上运行。由于广泛的平台支持,Antora也被用于许多云平台和持续集成交付服务器。

平台

我们的一般政策是将Antora对平台版本的支持与上游项目对该版本的生命周期计划对齐。当平台版本达到维护者的活跃支持结束或终止生命周期(以先到者为准)时,Antora将不再支持该版本。

支持的平台 支持的版本

Alpine Linux

≥ 3.13

Debian

≥ 10.12

Fedora

≥ 35

Ubuntu

18.04 LTS
20.04 LTS

macOS

Catalina (10.15)
Big Sur (11.6)
Monterey (12.4)

Microsoft

Windows 10
Windows 11
Windows Server 2016
Windows Server 2019

Chrome

最新稳定版本

Firefox

最新稳定版本

MS Edge

最新稳定版本

Node.js

LTS (≥ 16)

关于Antora测试套件

截至最后统计,Antora拥有超过2008个测试用例,覆盖99%的代码行。可以说我们对编写高质量测试和提高测试覆盖率有点痴迷。

云平台

Antora应该在常见的云平台上按设计运行。您如何配置云实例取决于您的工作负载要求和远程git存储库的大小。如果您在云平台上运行Antora,我们很乐意听取您在Antora的社区聊天中的体验。

硬件建议

您的硬件要求主要取决于Antora流水线从远程git存储库获取内容时的大小。

当Antora首次运行时,它会获取并克隆playbook中指定的所有远程git存储库。此操作的速度取决于远程存储库的大小、环境输入/输出参数和网络性能。首次运行后,Antora会在本地缓存存储库。在后续运行中,只有在启用fetch选项或删除缓存文件夹时,Antora才会重新连接到远程存储库。

RAM

内存要求取决于您的Git存储库的大小。3GB应该提供足够的余地。

I/O

最大吞吐量和最小延迟总是会让事情变得更好,但不是必需的。

调整内存限制

即使您使用的机器具有足够的内存(RAM),也不会将所有内存分配给Node.js进程。如果Node.js进程尝试使用超过分配给它的内存量,系统可能会终止Node.js进程(SIGKILL)。

Node.js从保守的内存限制开始(通常为2048 MiB,但这取决于系统)。您可以使用--max-old-space-size CLI选项将更多内存分配给Node.js进程。在运行Antora时,您可以通过NODE_OPTIONS环境变量将此选项传递给Node.js。

NODE_OPTIONS="--max-old-space-size=4096"

您需要尝试不同的值以找到最适合您站点的设置。有关此主题的更多信息,请参阅如何确定Node.js的正确"max-old-space-size"值?

了解更多