docs.yaxa.co — mantenimiento

Este vault mismo.

Reiniciar Quartz

cd /home/ubuntu/docs-stack
docker compose restart
docker logs -f yaxa-docs-quartz --tail=50

Ver estado

# Container:
docker ps --filter name=yaxa-docs-quartz
 
# Responde localmente?
curl -sI http://127.0.0.1:4322 | head -3
 
# Responde via CF?
curl -sI https://docs.yaxa.co | head -5

Rebuild manual

Quartz corre con --serve --watch, así que detecta cambios automáticamente. Si por algún motivo no rebuilds:

docker restart yaxa-docs-quartz

El rebuild completo tarda ~500ms para 8 archivos; escala ~linealmente.

Agregar una sección nueva (carpeta)

1. mkdir /home/ubuntu/docs-vault/<seccion>/

2. Crear index.md con frontmatter:

   ---
   title: <Título>
   tags: [<tag>]
   ---

3. Linkear desde index raíz del vault

El watcher de Quartz detecta el cambio y lo rebuildea.

Purgar cache Cloudflare

Las páginas del vault llevan Cache-Control: no-store forzado desde nginx, pero si CF cacheó antes del fix:

• CF dashboard → zona yaxa.co → Caching → Purge Custom → https://docs.yaxa.co/*

Regenerar cert SSL

Ver letsencrypt-renewal con <dom>=docs.yaxa.co.

Re-deployar vhost si Virtualmin lo sobreescribe

sudo cp /home/ubuntu/docs-stack/docs.yaxa.co.conf /etc/nginx/sites-available/docs.yaxa.co.conf
sudo cp /etc/nginx/sites-available/docs.yaxa.co.conf /etc/nginx/sites-enabled/docs.yaxa.co.conf
sudo nginx -t && sudo systemctl reload nginx

Backup del vault

Es un git repo en /home/ubuntu/docs-vault/. Commits locales. Si querés push a remoto:

cd /home/ubuntu/docs-vault
git remote add origin <url>
git push -u origin main

(Aún sin remoto configurado.)