我們在 Ayakaleaf Pro 6.3.1 上使用 Toolkit 進行量測,環境為執行 Ubuntu 24.04 的 2 vCPU / 2 GiB QEMU/KVM 虛擬機,並開啟沙箱編譯(
texlive-basic:2025.1)與 Git 整合。為什麼預設情況下 2 GB 不夠用
在預設設定下,Ayakaleaf Pro 閒置時大約需要 1.9 GiB。Ubuntu 和 Docker 已經佔用了 2 GiB 機器中的 364 MiB,剩下大約 1600 MiB。
- 加上 2 GB 交換空間
這是最重要的一步。
- 降低記憶體用量
將以下幾行加入 config/variables.env。Git 整合容器也會讀取這個檔案。
variables.env
config/docker-compose.override.yml(也就是設定 Ayakaleaf Pro 映像檔的同一個檔案)的 services 下加入一個 mongo 項目:
docker-compose.override.yml
bin/up -d。
當堆積為 160 MiB 時,透過 Git 複製或推送大型專案可能會耗盡記憶體,Git 整合容器會隨之重新啟動。我們沒有測試這種情況。如果發生這種情況,請調高
-Xmx。
結果
每次測試都編譯一份 33 頁的 LuaLaTeX 文件,使用fontspec 和 30 個 TikZ 圖形;並行編譯使用的是不同的專案。
沒有交換空間時,一次記憶體不足終止會引發下一次:
web 重新啟動,啟動又需要記憶體,伺服器會一直停滯,直到硬重設。有交換空間時,同時進行三次編譯所需時間與一次編譯差不多,因為被換出到交換空間的是閒置的 Node.js 記憶體頁面。
未測試:Git 複製和推送負載、大量使用者同時編輯,以及慢速磁碟上的交換空間(我們的主機使用的是 SSD)。
Kubernetes
我們的 Kubernetes 指南會在節點上關閉交換空間(準備節點),因此那裡只適用第 2 步。請將NODE_OPTIONS 和 MALLOC_ARENA_MAX 放入 overleaf-env ConfigMap(個人化您的執行個體)。MongoDB 快取已在部署 MongoDB 與 Redis 中設定。
