Dokumentace (MkDocs)

Dvě samostatné instance MkDocs:

wiki.mixi.cz (v1)

Zdrojové soubory na NFS: /mnt/nfs/mifs01/kube/mkdocs/docs/. MkDocs serve běží jako Deployment, obsah mountuje přímo z NFS. Změna = okamžitě viditelná bez restartu.

Pluginy: mkdocs-material, mermaid2, callouts, pymdownx extensions.

doc.mixi.cz (v2 — image-baked pipeline)

Obsah je uložen v Forgejo repozitáři (doc-mixi-cz-content). Každý push na main spustí Actions workflow:

push → mkdocs build --strict → docker build → push mifs01.intranet:5001/mkdocs-doc:<sha> → kubectl set image → rolling update

Serving: nginx:alpine, statický obsah baked do image. Žádná závislost na NFS za runtime.

Deployment

Namespace default, název mkdocs-doc. Manifesty v docker/mkdocs2/.

Přístup přes Authelia ForwardAuth (middleware authelia-authelia@kubernetescrd).

Rollback

kubectl -n default rollout undo deployment/mkdocs-doc

Image pruning

Weekly CronJob mkdocs-doc-image-pruner (každou neděli 03:30) — zachová 10 nejnovějších tagů a tagy mladší 30 dní. Používá mifs01.intranet:5001/tools/image-pruner:v1 (viz Docker Registry).

Po pruning je potřeba spustit GC na mifs01 pro uvolnění disku (viz Docker Registry).

Obsah a Obsidian

Obsah repozitáře je kompatibilní s Obsidian (jako vault). Plugin Obsidian-Git zajišťuje automatický push každých 5 minut → spouští pipeline.