0. Příprava uzlů

Nainstalujte na uzly Docker Engine, containerd a kubeadm a stáhněte obrazy TeX Live.

Ayakaleaf Pro kompiluje LaTeX v izolovaných (sandboxed) kontejnerech TeX Live. Spouští je sám, přes Docker socket stroje, na kterém běží. Na Kubernetes to znamená:

• každý uzel, na kterém může běžet pod Ayakaleaf Pro, má nainstalovaný a spuštěný Docker Engine;
• každý obraz TeX Live, který nakonfigurujete, je na každém z těchto uzlů stažen do Dockeru.

Kubelet může nadále používat containerd: Docker Engine obsahuje containerd.io a oba používají stejného démona v různých jmenných prostorech.

Spravované node pooly bez Dockeru (většina výchozích nastavení EKS, GKE a AKS) nemohou spouštět sandboxed compiles. Používejte node pooly, na které lze nainstalovat Docker Engine, nebo takové uzly označte labelem a udržujte na nich Ayakaleaf Pro pomocí nodeSelector.

Níže uvedené kroky jsou pro Ubuntu 24.04 a cluster sestavený pomocí kubeadm. Pokud váš cluster již existuje, proveďte kroky 1, 2 a 5 na uzlech, na kterých poběží Ayakaleaf Pro.

1. Moduly jádra a sysctl

   printf 'overlay\nbr_netfilter\n' | sudo tee /etc/modules-load.d/k8s.conf
   sudo modprobe overlay && sudo modprobe br_netfilter
   printf 'net.bridge.bridge-nf-call-iptables=1\nnet.bridge.bridge-nf-call-ip6tables=1\nnet.ipv4.ip_forward=1\n' \
     | sudo tee /etc/sysctl.d/99-k8s.conf
   sudo sysctl --system
   sudo swapoff -a   # and comment out swap in /etc/fstab
   
2. Docker Engine

   Nainstalujte Docker Engine z repozitáře Dockeru podle kroku 0. Nastavení Dockeru. Plugin Compose není potřeba. Tím se nainstaluje také containerd.io.

3. containerd pro kubelet

   Balíček containerd.io z repozitáře Dockeru má vypnutý plugin CRI. Zapište úplnou výchozí konfiguraci, která jej zapne, a přepněte ji na systemd cgroups:

   containerd config default | sudo tee /etc/containerd/config.toml >/dev/null
   sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
   # containerd 2.x writes config_path = '' and ignores /etc/containerd/certs.d without this
   sudo sed -i "s|config_path = ''|config_path = '/etc/containerd/certs.d'|" /etc/containerd/config.toml
   sudo systemctl restart containerd docker
   
4. kubeadm, kubelet a kubectl

   Postupujte podle návodu Installing kubeadm, poté vytvořte cluster pomocí kubeadm init a kubeadm join a nainstalujte síťový plugin. Například s flannel:

   kubeadm-config.yaml

   apiVersion: kubeadm.k8s.io/v1beta4
   kind: ClusterConfiguration
   networking:
     podSubnet: 10.244.0.0/16   # flannel's default
   ---
   apiVersion: kubelet.config.k8s.io/v1beta1
   kind: KubeletConfiguration
   cgroupDriver: systemd
   # Compile containers are started by Docker, outside the kubelet's accounting: keep memory for them
   systemReserved:
     memory: 300Mi
   kubeReserved:
     memory: 200Mi
   

   sudo kubeadm init --config kubeadm-config.yaml
   kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml
   

   Cluster také potřebuje výchozí StorageClass. Pro testovací cluster postačí local-path-provisioner; v produkci použijte blokové úložiště své platformy (Longhorn, Ceph, cloudový ovladač CSI).

5. Obrazy TeX Live

   Na každém uzlu, na kterém může běžet Ayakaleaf Pro, stáhněte pomocí Dockeru obrazy TeX Live, které uvedete v ALL_TEX_LIVE_DOCKER_IMAGES, například:

   sudo docker pull ghcr.io/ayaka-notes/texlive-full:2026.1
   

   crictl pull ani ctr zde nepomohou: Ayakaleaf Pro žádá o obraz Docker. Úplné obrazy jsou velké (každý kolem 28 GB); jejich seznam najdete v části Sandboxed Compiles. Pro první test stačí ghcr.io/ayaka-notes/texlive-basic:2026.1 (asi 630 MB, minimální TeX Live).

​

Q&A

Mohu provozovat Ayakaleaf Pro na uzlech bez Dockeru?

Odpověď: Pouze se SANDBOXED_COMPILES=false. Kompilace pak běží uvnitř kontejneru Ayakaleaf Pro s jeho malým vestavěným TeX Live a dokumenty LaTeX mohou číst a zapisovat vše, k čemu má tento kontejner přístup. Nedoporučujeme to; viz Sandboxed Compiles.

Započítávají se kompilace do limitu paměti podu?

Odpověď: Ne. Kontejnery TeX Live spouští Docker uzlu, mimo pod a mimo dohled kubeletu. Ponechte jim na uzlu volnou paměť, například pomocí systemReserved jako výše, a nezaplňujte uzel dalšími pody.