LaTeX kullanıcı yardımı ekleme

Kubernetes dağıtımında bir MediaWiki sitesindeki LaTeX yardım sayfalarını /learn altında sunun.

/learn sayfaları, her Ayakaleaf Pro pod’unun web hizmeti (learn modülü) tarafından, WIKI_URL ile ayarlanan wiki’nin önbelleğinden sunulur. Modülün ne yaptığı ve hangi wiki’lerin çalıştığı LaTeX kullanıcı yardımı ekleme sayfasında açıklanmıştır.

Hizmet	web (learn modülü), her Ayakaleaf Pro pod’unda
Pod → dış dünya	WIKI_URL (varsayılan https://learnwiki.overleaf.com): ilk başlatmada tüm sayfalar, ardından bir kullanıcı WIKI_MAX_CACHE_AGE süresinden sonra açtığında ilgili sayfa yeniden
Tarayıcı → dış dünya	sayfaların görselleri, doğrudan WIKI_URL adresinden
Depolanan veriler	veri biriminde /var/lib/overleaf/data/learnPages içindeki sayfa önbelleği
Periyodik işler	yok: sayfalar kullanıcılar açtığında yenilenir

​

Yapılandırma

30-config.yaml (additions)

  OVERLEAF_PROXY_LEARN: "true"
  # optional: your own MediaWiki
  # WIKI_URL: https://wiki.example.com

kubectl apply -f 30-config.yaml
kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf
kubectl -n overleaf rollout status deployment/overleaf --timeout=30m

Modül açıkken ilk başlatmada web hizmeti, istekleri kabul etmeden önce tüm wiki’yi indirir; bu işlem birkaç dakika sürer. Pod o zamana kadar hazır olmaz; bu nedenle bunu rollout status --timeout değerinde ve eklediğiniz başlangıç (startup) veya canlılık (liveness) yoklamalarında hesaba katın. Sonraki başlatmalar veri birimindeki önbelleği yeniden kullanır.

İlk başlatmada, henüz bir önbellek yokken, pod’ların WIKI_URL adresine erişebilmesi gerekir: erişemezlerse web hizmeti başlarken başarısız olur ve pod içinde tekrar tekrar yeniden başlatılır; böylece pod hiçbir zaman hazır olmaz. Modülü kapatın veya pod’ların wiki’ye çıkışına izin verin. Önbellek oluştuktan sonra pod’lar başlar ve wiki’ye erişilemediği sırada da önbellekteki sayfaları sunar.

​

Birden fazla replika

Her replika kendi önbelleğini kendi düğümünün diskinde tutar; bu nedenle her biri ilk başlatmasında wiki’yi indirir. podManagementPolicy: OrderedReady ile bunu birbiri ardına yaparlar. Bir kullanıcı, sayfa orada yenilenene kadar başka bir replikada sayfanın biraz farklı bir sürümünü görebilir.

​

Kubernetes üzerinde test edildi

HAProxy arkasında üç replikalı Kubernetes 1.37 üzerinde, her biri ilk başlatmasında https://learnwiki.overleaf.com adresini kendi düğümünün önbelleğine indirirken, /learn için uçtan uca testlerimiz başarılı oldu (12 vaka): başlıktaki Documentation bağlantısı, karşılama mesajı ve düzenleyicinin Help menüsü, içindekiler kenar çubuğu, wiki içindeki sayfalar, bağlantılar ve yönlendirmeler, wiki’den yüklenen görseller, bilinmeyen sayfalar için 404, herkese açık erişim olmadan gereken oturum açma ve WIKI_URL erişilemeyen bir adrese değiştirildikten sonra önbellekten sunulan eski bir sayfa. Boş bir önbellekle ve bağlantıları reddeden bir adrese işaret eden WIKI_URL ile başlatıldığında pod yeniden başlamadan hazır olmayan durumda kaldı; içindeki web hizmeti ise üç dakikada 77 kez başlayıp başarısız oldu.