MkDocs¶
Esta documentación, servida como sitio estático vía Nginx.
Información¶
| Campo | Valor |
|---|---|
| Contenedor | mkdocs |
| Imagen | Build local (docs/Dockerfile) |
| Compose | docs/docker-compose.docs.yml |
| Red | hosting-network |
Puertos¶
| Puerto | Variable | Default |
|---|---|---|
| Host → 80 | MKDOCS_PUBLISH |
8000 |
Acceso LAN: http://192.168.1.6:8000
Build¶
El Dockerfile hace un build multi-stage:
- Builder: Python 3.12 +
mkdocs build - Runtime: Nginx Alpine sirve
docs/.site/
Desarrollo local¶
pip install -r docs/requirements-mkdocs.txt
mkdocs serve
O con Docker (perfil dev):
docker compose --profile dev up mkdocs-dev
Puerto dev: MKDOCS_DEV_PUBLISH (default 8001).
Publicación pública¶
Opcionalmente se puede exponer vía NPM + Cloudflare Tunnel (ej. docs.kashflow.site).