支持的平台和系统要求
Antora可在Linux、macOS和Windows上运行。由于广泛的平台支持,Antora也被用于许多云平台和持续集成交付服务器。
平台
我们的一般政策是将Antora对平台版本的支持与上游项目对该版本的生命周期计划对齐。当平台版本达到维护者的活跃支持结束或终止生命周期(以先到者为准)时,Antora将不再支持该版本。
支持的平台 | 支持的版本 |
---|---|
Alpine Linux |
≥ 3.13 |
Debian |
≥ 10.12 |
Fedora |
≥ 35 |
Ubuntu |
18.04 LTS |
macOS |
Catalina (10.15) |
Microsoft |
Windows 10 |
Chrome |
最新稳定版本 |
Firefox |
最新稳定版本 |
MS Edge |
最新稳定版本 |
Node.js |
LTS (≥ 16) |
云平台
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"值?。
了解更多
-
首次在以下平台上安装Antora:
-
尝试官方的Antora Docker容器。