Solución de Problemas

Diagnostica y corrige problemas comunes . una página por familia de síntoma, escrita para que la corrección sea alcanzable sin leer antes el resto de la documentación.

En esta sección

• Fallos de Build . promoción bloqueada, errores de render, timeouts y explosiones del write-budget; dónde viven el texto de la razón y el control "promote anyway".
• CSS Bloqueado (SRI) . cuando el admin se niega a cargar el stylesheet y por qué el hash de integridad deriva del contenido.
• Conflictos de Puertos . qué puerto pertenece a qué capa, quién es su dueño, y cómo moverlo de forma limpia.
• Problemas de Login y Auth . lockouts, expiración, suspensiones, revocación de sesión.
• Redirects y 404 . por qué un site estático da 404 donde el CMS respondería, y las reglas de los formatos de redirect.
• FAQ . el recopilatorio de preguntas frecuentes (contraseñas, builds, lockouts, API keys, configuración del primer arranque).

El hábito que resuelve la mayoría

Dos superficies responden la mayoría de las preguntas antes de cazar síntomas:

• El build history (Builds en el admin) . las últimas 100 corridas con razones por chequeo, salida capturada, y el texto exacto de rechazo para promotes bloqueados.
• El journal (journalctl -u chinaski@<N>) . cada mensaje a nivel de servicio incluidos lockouts de login, fallos de deploy, y resultados de webhooks.

/health (multi-chequeo con detalles por chequeo) y /api/health (resumen para monitores) cierran el círculo: cuando ninguno reporta healthy, el problema es de infraestructura en lugar de de contenido.