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, а не змінні середовища; що їх замінює, описано в розділі «Запитання та відповіді» наприкінці цієї сторінки.

​

Функції

Для кожної функції конфігурації Toolkit тут є сторінка з її службами, налаштуваннями, мережевими шляхами, фоновими завданнями, тим, що змінюється за кількох реплік, і тим, як її було перевірено:

Функція	Служби в поді	Окрім ConfigMap і Secret
Автентифікація: OIDC, SAML, LDAP, Публічний доступ, reCAPTCHA, Обмеження паролів	web	секрети клієнтів, сертифікат IdP, CA LDAP
Ізольовані компіляції	clsi	Docker Engine і образи TeX Live на кожному вузлі
Імпорт та експорт Pandoc	clsi, web	образ Pandoc у Docker на кожному вузлі
Інтеграція з Git	git-bridge (власний под), web, history-v1	StatefulSet git-bridge і дві служби Service
Синхронізація з GitHub, GitLab, Gitea	web	Інтеграція з Git
Синхронізація з Dropbox	web, third-party-datastore, document-updater	Інтеграція з Git, webhook, доступний з інтернету, індекси бази даних
Інтеграція з Zotero, Mendeley	web	пароль шифрування в Secret
MCP-сервер	web	Інтеграція з Git
Інтеграція ШІ	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-проксі	ваш ingress або балансувальник навантаження	TLS завершується перед подами
Брендування	web	–
Локалізація	web	одне ім’я хоста для кожної мови
Доставка електронної пошти	web	–
Redis	кожна служба з активним станом	–
S3	history-v1, filestore	служба S3, обов’язкова для кількох реплік
Додавання довідки LaTeX для користувачів	web	поди мають мати доступ до wiki
Горизонтальне масштабування	усі	S3, балансувальник навантаження з липкими сесіями

​

Сертифікати та інші файли

Деякі функції приймають шлях до файлу замість значення: сертифікати SAML (OVERLEAF_SAML_IDP_CERT, …), CA LDAP (OVERLEAF_LDAP_TLS_OPTS_CA_PATH) або приватний CA для власного GitHub Enterprise, GitLab чи Gitea (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, і перезапустіть.

Паролі шифрування. Задайте в Secret кожен *_CIPHER_PASSWORD функцій, якими ви користуєтеся. Інакше деякі функції під час першого використання генерують файл ключа на томі даних: з однією реплікою це працює, доки том не буде втрачено, а з кількома репліками кожна репліка шифрувала б іншим ключем.

​

Запитання та відповіді

Які налаштування Toolkit з config/overleaf.rc мені потрібні?

Відповідь: Жодне з них Ayakaleaf Pro не зчитує. Їхні відповідники в Kubernetes:

config/overleaf.rc	Kubernetes
OVERLEAF_LISTEN_IP, OVERLEAF_PORT	Service (NodePort) або ваш ingress
SIBLING_CONTAINERS_ENABLED	SANDBOXED_COMPILES* у ConfigMap, сокет Docker у поді
GIT_BRIDGE_ENABLED	Інтеграція з Git
MONGO_ENABLED, REDIS_ENABLED, MONGO_URL, REDIS_HOST	StatefulSet або ваші керовані служби, OVERLEAF_MONGO_URL і OVERLEAF_REDIS_HOST
REDIS_AOF_PERSISTENCE	--appendonly yes у 20-redis.yaml
NGINX_ENABLED, TLS_*	ваш ingress або балансувальник навантаження