Kubernetes

Konfigurera en Kubernetes-driftsättning - var inställningar, hemligheter och filer placeras, och en sida per funktion.

En Kubernetes-driftsättning läser samma miljövariabler som Toolkit. Där en Toolkit-sida säger ”lägg till detta i config/variables.env” lägger du värdet i ConfigMap overleaf-env, eller i Secret overleaf-secrets när det är ett lösenord, en nyckel eller en token. Starta sedan om:

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

Värden i config/overleaf.rc är Toolkit-inställningar, inte miljövariabler; avsnittet Frågor och svar i slutet av den här sidan beskriver vad som ersätter dem.

​

Funktioner

Varje funktion i Toolkit-konfigurationen har en sida här med dess tjänster, inställningar, nätverksvägar, bakgrundsjobb, vad som ändras med flera repliker och hur den har testats:

Funktion	Tjänster i podden	Utöver ConfigMap och Secret
Autentisering: OIDC, SAML, LDAP, Offentlig åtkomst, reCAPTCHA, Lösenordsbegränsningar	web	klienthemligheter, IdP-certifikatet, LDAP-CA:n
Sandlådekompilering	clsi	Docker Engine och TeX Live-avbildningarna på varje nod
Import och export med Pandoc	clsi, web	Pandoc-avbildningen i Docker på varje nod
Git-integration	git-bridge (egen pod), web, history-v1	StatefulSet för git-bridge och två Services
Synkronisering med GitHub, GitLab, Gitea	web	Git-integration
Dropbox-synkronisering	web, third-party-datastore, document-updater	Git-integration, webhooken nåbar från internet, databasindex
Integration med Zotero, Mendeley	web	chifferlösenordet i Secret
MCP-server	web	Git-integration
AI-integration	web, linked-url-proxy	–
Overleaf Import API	web, linked-url-proxy	–
Mallar	web, filestore	S3 för flera repliker
Extern URL	linked-url-proxy	offentliga nodadresser i OVERLEAF_LINKED_URL_BLOCKED_NETWORKS
Loggning	alla tjänster	en volym på /var/log/overleaf för att behålla loggar
TLS-proxy	din ingress eller lastbalanserare	TLS avslutas framför poddarna
Varumärkesanpassning	web	–
Lokalisering	web	ett värdnamn per språk
E-postleverans	web	–
Redis	alla tjänster med aktivt tillstånd	–
S3	history-v1, filestore	en S3-tjänst, krävs för flera repliker
Lägga till LaTeX-hjälp för användare	web	poddarna måste nå wikin
Horisontell skalning	alla	S3, en lastbalanserare med sticky sessions

​

Certifikat och andra filer

Vissa funktioner tar en filsökväg i stället för ett värde: SAML-certifikaten (OVERLEAF_SAML_IDP_CERT, …), LDAP-CA:n (OVERLEAF_LDAP_TLS_OPTS_CA_PATH) eller en privat CA för en egenhostad GitHub Enterprise, GitLab eller Gitea (NODE_EXTRA_CA_CERTS). Lägg filerna i en Secret och montera den där Toolkit-sidorna förväntar sig dem, /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

Hänvisa sedan till dem via sökväg i ConfigMap, till exempel NODE_EXTRA_CA_CERTS: /var/lib/overleaf/certs/ca.pem, och starta om.

Chifferlösenord. Ange varje *_CIPHER_PASSWORD för de funktioner du använder i Secret. Annars genererar vissa funktioner en nyckelfil på datavolymen vid första användningen: med en replik fungerar det tills volymen går förlorad, med flera repliker skulle varje replik kryptera med en annan nyckel.

​

Frågor och svar

Vilka Toolkit-inställningar från config/overleaf.rc behöver jag?

Svar: Ingen av dem läses av Ayakaleaf Pro. Deras motsvarigheter i Kubernetes:

config/overleaf.rc	Kubernetes
OVERLEAF_LISTEN_IP, OVERLEAF_PORT	Service (NodePort) eller din ingress
SIBLING_CONTAINERS_ENABLED	SANDBOXED_COMPILES* i ConfigMap, Docker-socketen i podden
GIT_BRIDGE_ENABLED	Git-integration
MONGO_ENABLED, REDIS_ENABLED, MONGO_URL, REDIS_HOST	StatefulSets eller dina hanterade tjänster, OVERLEAF_MONGO_URL och OVERLEAF_REDIS_HOST
REDIS_AOF_PERSISTENCE	--appendonly yes i 20-redis.yaml
NGINX_ENABLED, TLS_*	din ingress eller lastbalanserare