Kubernetes

Määritä Kubernetes-käyttöönotto - minne asetukset, salaisuudet ja tiedostot sijoitetaan, sekä yksi sivu kutakin ominaisuutta kohden.

Kubernetes-käyttöönotto lukee samat ympäristömuuttujat kuin Toolkit. Kun Toolkit-sivu sanoo ”lisää tämä tiedostoon config/variables.env”, vie arvo ConfigMapiin overleaf-env, tai Secretiin overleaf-secrets, kun kyseessä on salasana, avain tai tunniste. Käynnistä sitten uudelleen:

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

Tiedoston config/overleaf.rc arvot ovat Toolkitin asetuksia, eivät ympäristömuuttujia; tämän sivun lopussa olevat kysymykset ja vastaukset kertovat, mikä ne korvaa.

​

Ominaisuudet

Jokaisella Toolkit-konfiguraation ominaisuudella on täällä oma sivunsa, jolla kuvataan sen palvelut, asetukset, verkkoyhteydet, taustatehtävät, mitä useat replikat muuttavat ja miten se on testattu:

Ominaisuus	Palvelut podissa	ConfigMapin ja Secretin lisäksi
Todennus: OIDC, SAML, LDAP, Julkinen käyttö, reCAPTCHA, Salasanarajoitukset	web	asiakassalaisuudet, IdP:n varmenne, LDAP:n CA
Hiekkalaatikkokäännökset	clsi	Docker Engine ja TeX Live -imaget jokaisella solmulla
Pandoc-tuonti ja -vienti	clsi, web	Pandoc-image Dockerissa jokaisella solmulla
Git-integraatio	git-bridge (oma pod), web, history-v1	git-bridge-StatefulSet ja kaksi Serviceä
GitHub-, GitLab- ja Gitea-synkronointi	web	Git-integraatio
Dropbox-synkronointi	web, third-party-datastore, document-updater	Git-integraatio, internetistä tavoitettava webhook, tietokantaindeksit
Zotero- ja Mendeley-integraatio	web	salaussalasana Secretissä
MCP-palvelin	web	Git-integraatio
Tekoälyintegraatio	web, linked-url-proxy	–
Overleaf Import API	web, linked-url-proxy	–
Mallipohjat	web, filestore	S3 useille replikoille
Ulkoinen URL-osoite	linked-url-proxy	solmujen julkiset osoitteet muuttujassa OVERLEAF_LINKED_URL_BLOCKED_NETWORKS
Lokit	jokainen palvelu	taltio polussa /var/log/overleaf lokien säilyttämiseksi
TLS-välityspalvelin	ingress tai kuormantasaaja	TLS päättyy podien edessä
Brändäys	web	–
Lokalisointi	web	yksi isäntänimi kieltä kohden
Sähköpostin toimitus	web	–
Redis	jokainen palvelu, jolla on reaaliaikaista tilaa	–
S3	history-v1, filestore	S3-palvelu, pakollinen useille replikoille
LaTeX-käyttäjäohjeiden lisääminen	web	podien on tavoitettava wiki
Horisontaalinen skaalaus	kaikki	S3, kuormantasaaja pysyvillä istunnoilla

​

Varmenteet ja muut tiedostot

Jotkin ominaisuudet ottavat arvon sijaan tiedostopolun: SAML-varmenteet (OVERLEAF_SAML_IDP_CERT, …), LDAP:n CA (OVERLEAF_LDAP_TLS_OPTS_CA_PATH) tai yksityinen CA itse isännöidylle GitHub Enterpriselle, GitLabille tai Gitealle (NODE_EXTRA_CA_CERTS). Vie tiedostot Secretiin ja liitä se sinne, missä Toolkit-sivut odottavat niitä, eli polkuun /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

Viittaa niihin sitten polulla ConfigMapissa, esimerkiksi NODE_EXTRA_CA_CERTS: /var/lib/overleaf/certs/ca.pem, ja käynnistä uudelleen.

Salaussalasanat. Aseta Secretiin jokainen käyttämiesi ominaisuuksien *_CIPHER_PASSWORD. Muuten jotkin ominaisuudet luovat avaintiedoston datataltiolle ensimmäisellä käyttökerralla: yhdellä replikalla tämä toimii, kunnes taltio menetetään, mutta useilla replikoilla kukin replika salaisi eri avaimella.

​

Kysymyksiä ja vastauksia

Mitä Toolkitin asetuksia tiedostosta config/overleaf.rc tarvitsen?

Vastaus: Ayakaleaf Pro ei lue niistä yhtäkään. Niiden Kubernetes-vastineet:

config/overleaf.rc	Kubernetes
OVERLEAF_LISTEN_IP, OVERLEAF_PORT	Service (NodePort) tai ingress
SIBLING_CONTAINERS_ENABLED	SANDBOXED_COMPILES* ConfigMapissa, Docker-socket podissa
GIT_BRIDGE_ENABLED	Git-integraatio
MONGO_ENABLED, REDIS_ENABLED, MONGO_URL, REDIS_HOST	StatefulSetit tai hallinnoidut palvelusi, OVERLEAF_MONGO_URL ja OVERLEAF_REDIS_HOST
REDIS_AOF_PERSISTENCE	--appendonly yes tiedostossa 20-redis.yaml
NGINX_ENABLED, TLS_*	ingress tai kuormantasaaja