Kubernetes

Kubernetes 배포를 구성합니다 - 설정, 시크릿, 파일을 두는 위치와 기능별 안내 페이지.

Kubernetes 배포는 Toolkit과 동일한 환경 변수를 읽습니다. Toolkit 페이지에서 “config/variables.env에 추가하세요”라고 안내하는 경우, 해당 값을 ConfigMap overleaf-env에 넣거나, 비밀번호, 키 또는 토큰이라면 Secret overleaf-secrets에 넣으세요. 그런 다음 재시작합니다.

kubectl -n overleaf apply -f 30-config.yaml        # after editing the ConfigMap
kubectl -n overleaf patch secret overleaf-secrets --type merge \
  -p '{"stringData":{"GITHUB_TOKEN_CIPHER_PASSWORD":"'"$(openssl rand -hex 32)"'"}}'
kubectl -n overleaf rollout restart deployment/overleaf

config/overleaf.rc의 값은 환경 변수가 아니라 Toolkit 설정입니다. 이를 대체하는 항목은 이 페이지 끝의 Q&A를 참고하세요.

​

기능

Toolkit 구성의 각 기능마다 이곳에 페이지가 있으며, 해당 서비스, 설정, 네트워크 경로, 백그라운드 작업, 여러 레플리카에서 달라지는 점, 그리고 테스트 방법을 다룹니다.

기능	파드 내 서비스	ConfigMap과 Secret 외에 필요한 것
인증: OIDC, SAML, LDAP, 공개 접근, reCAPTCHA, 비밀번호 제한	web	클라이언트 시크릿, IdP 인증서, LDAP CA
샌드박스 컴파일	clsi	모든 노드의 Docker Engine과 TeX Live 이미지
Pandoc 가져오기 및 내보내기	clsi, web	모든 노드의 Docker에 있는 Pandoc 이미지
Git 연동	git-bridge(자체 파드), web, history-v1	git-bridge StatefulSet과 Service 두 개
GitHub, GitLab, Gitea 동기화	web	Git 연동
Dropbox 동기화	web, third-party-datastore, document-updater	Git 연동, 인터넷에서 접근 가능한 웹훅, 데이터베이스 인덱스
Zotero, Mendeley 연동	web	Secret의 암호화 비밀번호
MCP 서버	web	Git 연동
AI 통합	web, linked-url-proxy	–
Overleaf Import API	web, linked-url-proxy	–
템플릿	web, filestore	여러 레플리카의 경우 S3
외부 URL	linked-url-proxy	OVERLEAF_LINKED_URL_BLOCKED_NETWORKS에 공개 노드 주소
로깅	모든 서비스	로그를 보관하기 위한 /var/log/overleaf의 볼륨
TLS 프록시	인그레스 또는 로드 밸런서	파드 앞에서 TLS 종료
브랜딩	web	–
현지화	web	언어별 호스트 이름 하나
이메일 전송	web	–
Redis	실시간 상태를 가진 모든 서비스	–
S3	history-v1, filestore	S3 서비스, 여러 레플리카에 필수
LaTeX 사용자 도움말 추가	web	파드가 위키에 접근할 수 있어야 함
수평 확장	전체	S3, 스티키 세션을 지원하는 로드 밸런서

​

인증서 및 기타 파일

일부 기능은 값 대신 파일 경로를 받습니다. SAML 인증서(OVERLEAF_SAML_IDP_CERT, …), LDAP CA(OVERLEAF_LDAP_TLS_OPTS_CA_PATH), 또는 자체 호스팅 GitHub Enterprise, GitLab, Gitea를 위한 사설 CA(NODE_EXTRA_CA_CERTS)가 그렇습니다. 파일을 Secret에 넣고 Toolkit 페이지가 기대하는 위치인 /var/lib/overleaf/certs에 마운트하세요.

kubectl -n overleaf create secret generic overleaf-certs --from-file=idp_cert.pem --from-file=ca.pem

40-overleaf.yaml (additions)

          volumeMounts:
            # ...
            - name: certs
              mountPath: /var/lib/overleaf/certs
              readOnly: true
      volumes:
        # ...
        - name: certs
          secret:
            secretName: overleaf-certs

그런 다음 ConfigMap에서 경로로 참조하고(예: NODE_EXTRA_CA_CERTS: /var/lib/overleaf/certs/ca.pem) 재시작하세요.

암호화 비밀번호. 사용하는 기능의 모든 *_CIPHER_PASSWORD를 Secret에 설정하세요. 그렇지 않으면 일부 기능은 처음 사용할 때 데이터 볼륨에 키 파일을 생성합니다. 레플리카가 하나라면 볼륨을 잃기 전까지는 동작하지만, 레플리카가 여러 개라면 각 레플리카가 서로 다른 키로 암호화하게 됩니다.

​

Q&A

config/overleaf.rc의 Toolkit 설정 중 어떤 것이 필요한가요?

답변: Ayakaleaf Pro는 그중 어떤 것도 읽지 않습니다. Kubernetes에서 대응하는 항목은 다음과 같습니다.

config/overleaf.rc	Kubernetes
OVERLEAF_LISTEN_IP, OVERLEAF_PORT	Service(NodePort) 또는 인그레스
SIBLING_CONTAINERS_ENABLED	ConfigMap의 SANDBOXED_COMPILES*, 파드의 Docker 소켓
GIT_BRIDGE_ENABLED	Git 연동
MONGO_ENABLED, REDIS_ENABLED, MONGO_URL, REDIS_HOST	StatefulSet 또는 관리형 서비스, OVERLEAF_MONGO_URL 및 OVERLEAF_REDIS_HOST
REDIS_AOF_PERSISTENCE	20-redis.yaml의 --appendonly yes
NGINX_ENABLED, TLS_*	인그레스 또는 로드 밸런서