이 측정은 Ubuntu 24.04를 실행하는 2 vCPU / 2 GiB QEMU/KVM 가상 머신에서 Toolkit으로 설치한 Ayakaleaf Pro 6.3.1을 대상으로, 샌드박스 컴파일(
texlive-basic:2025.1)과 Git 연동을 켠 상태로 수행했습니다.기본 설정에서 2 GB가 부족한 이유
기본 설정에서 Ayakaleaf Pro는 유휴 상태일 때 약 1.9 GiB가 필요합니다. 2 GiB 머신에서 Ubuntu와 Docker가 이미 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를 높이세요.
결과
각 테스트에서는fontspec과 TikZ 그림 30개가 포함된 33쪽 분량의 LuaLaTeX 문서를 컴파일했습니다. 동시 컴파일에는 서로 다른 프로젝트를 사용했습니다.
스왑이 없으면 메모리 부족으로 인한 종료가 연쇄적으로 일어납니다.
web이 재시작되고, 시작하는 데 다시 메모리가 필요해지며, 하드 리셋할 때까지 서버가 멈춥니다. 스왑이 있으면 동시에 세 번 컴파일해도 한 번 컴파일할 때와 거의 같은 시간이 걸립니다. 스왑으로 밀려나는 것은 유휴 상태의 Node.js 페이지이기 때문입니다.
테스트하지 않은 항목: Git 클론 및 푸시 부하, 많은 사용자의 동시 편집, 느린 디스크에서의 스왑(테스트 호스트는 SSD를 사용했습니다).
Kubernetes
Kubernetes 가이드에서는 노드의 스왑을 끄므로(노드 준비) 여기서는 2단계만 적용됩니다.NODE_OPTIONS와 MALLOC_ARENA_MAX는 overleaf-env ConfigMap에 넣으세요(인스턴스 개인화). MongoDB 캐시는 이미 MongoDB 및 Redis 배포에서 설정되어 있습니다.
