Import og eksport med Pandoc

Importer og eksporter dokumenter med Pandoc i en Kubernetes-distribusjon.

Pandoc-konverteringer kjøres av clsi-tjenesten i hver Ayakaleaf Pro-pod, på samme måte som kompileringer: clsi ber Docker Engine på noden om å starte en container fra PANDOC_IMAGE. web-tjenesten viser import- og eksportmenyene. Hva funksjonen gjør og hvordan du bygger imaget, er beskrevet i Import og eksport med Pandoc.

Tjenester	web (menyer og ruter), clsi (kjører konverteringen), i hver Ayakaleaf Pro-pod
Node	Docker Engine og PANDOC_IMAGE, på hver node som kan kjøre Ayakaleaf Pro
Krever	Sandboxed Compiles
Periodiske jobber	ingen

​

Konfigurasjon

1. Legg imaget inn i Docker på hver node

   Bygg imaget én gang fra mappen develop/pandoc i repositoriet ayakaleaf-pro, og last det deretter inn i Docker på hver node som kan kjøre Ayakaleaf Pro:

   docker build -t overleaf-pandoc:local develop/pandoc
   docker save overleaf-pandoc:local | ssh node-1 sudo docker load    # repeat for every node
   

   Eller push det til et register nodene kan nå, og kjør sudo docker pull på hver node. Som med TeX Live-imagene må det ligge i Docker, ikke bare i containerd.

2. ConfigMap

     ENABLE_PANDOC_CONVERSIONS: "true"
     PANDOC_IMAGE: overleaf-pandoc:local
   

   Både web og clsi leser ENABLE_PANDOC_CONVERSIONS fra den samme ConfigMap-en, så de kan ikke være uenige på Kubernetes.

3. Bruk og start på nytt

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

​

Flere replikaer

Ingenting ekstra utover at imaget finnes på hver node: hver replika konverterer på sin egen node.

​

Testet på Kubernetes

Med imaget bygget fra develop/pandoc og lastet inn i Docker på hver node med docker save | docker load, på Kubernetes 1.37 med én replika, består ende-til-ende-testene våre for Pandoc (6 tilfeller): import av et Markdown-dokument som et LaTeX-prosjekt, feilen som vises for et ødelagt Word-dokument, eksport til Word (som kan importeres igjen), Markdown og HTML, og menyene som skjules uten ENABLE_PANDOC_CONVERSIONS.