Vai al contenuto principale
Ayakaleaf Pro funziona su un server con 2 core di CPU e 2 GB di memoria, integrazione Git inclusa, non appena aggiungi 2 GB di swap. Senza swap esaurisce la memoria durante l’avvio. Le impostazioni del passaggio 2 riducono poi l’uso dello swap quasi della metà.
Lo abbiamo misurato su Ayakaleaf Pro 6.3.1 con il Toolkit, in una macchina virtuale QEMU/KVM da 2 vCPU / 2 GiB con Ubuntu 24.04, con le compilazioni in sandbox (texlive-basic:2025.1) e l’integrazione Git attive.

Perché 2 GB non bastano con le impostazioni predefinite

A riposo, con le impostazioni predefinite, Ayakaleaf Pro richiede circa 1,9 GiB. Ubuntu e Docker usano già 364 MiB di una macchina da 2 GiB, lasciando circa 1600 MiB.

  1. Aggiungere 2 GB di swap

Questo è il passaggio più importante.

  1. Ridurre l’uso della memoria

Aggiungi queste righe a config/variables.env. Anche il container dell’integrazione Git legge questo file.
variables.env
Per limitare la cache di MongoDB, aggiungi una voce mongo sotto services in config/docker-compose.override.yml (lo stesso file che imposta l’immagine di Ayakaleaf Pro):
docker-compose.override.yml
Poi esegui bin/up -d.
NODE_OPTIONS sostituisce il valore impostato nell’immagine, quindi la riga deve mantenere --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Senza di esse i servizi Node.js non riescono a caricare i loro pacchetti e non si avviano. Non è possibile usare --optimize-for-size: Node.js lo rifiuta in NODE_OPTIONS.--replSet overleaf è ciò che il Toolkit passa a MongoDB per impostazione predefinita. Mantienilo.
Con un heap di 160 MiB, clonare o fare push di un progetto grande tramite Git può esaurire la memoria, e il container dell’integrazione Git si riavvia. Non lo abbiamo testato. Se succede, aumenta -Xmx.

Risultati

Ogni test ha compilato un documento LuaLaTeX di 33 pagine con fontspec e 30 figure TikZ; le compilazioni simultanee riguardavano progetti diversi. Senza swap, un arresto per memoria esaurita porta al successivo: web si riavvia, il suo avvio richiede di nuovo memoria e il server si blocca fino a un reset forzato. Con lo swap, tre compilazioni insieme richiedono più o meno lo stesso tempo di una, perché finiscono nello swap le pagine inattive di Node.js. Non testato: il carico di clone e push Git, molti utenti che modificano contemporaneamente e lo swap su dischi lenti (il nostro host usava un SSD).

Kubernetes

La nostra guida Kubernetes disattiva lo swap sui nodi (Preparare i nodi), quindi lì vale solo il passaggio 2. Inserisci NODE_OPTIONS e MALLOC_ARENA_MAX nella ConfigMap overleaf-env (Personalizzare la tua istanza). La cache di MongoDB è già impostata in Distribuire MongoDB e Redis.
Ultima modifica il 21 novembre 2026