FAQ de verificación de despliegue y primer inicio de sesión en Emdash CMS
Comprobaciones prácticas de aceptación tras el despliegue, incluyendo la configuración inicial de admin y el diagnóstico de estados de éxito parcial.
¿Qué debo verificar primero después del despliegue?
Usa una secuencia de aceptación en tres capas:
- Frontend accesible: la home devuelve el contenido esperado.
- Admin accesible: carga
/_emdash/admin. - Datos escribibles: crea y lee un elemento de contenido.
La accesibilidad de rutas por sí sola no significa despliegue completado.
¿Por qué puede funcionar el frontend mientras falla la inicialización del admin?
Causas más comunes:
- desajuste de bindings (
DB,MEDIA, etc.) - variables de entorno o secretos faltantes
- configuración no compatible conservada para plan Free
Orden recomendado de triaje: primero bindings, segundo variables de entorno, tercero restricciones del nivel de funciones.
¿Qué ocurre durante el primer inicio de sesión de admin?
El primer inicio de sesión suele activar:
- creación de identidad de administrador
- registro de credenciales (como Passkey)
- escritura del estado inicial del sistema
Este paso depende del navegador y del estado de la cuenta. Complétalo con red estable y navegador compatible.
¿Qué debo revisar primero si falla la configuración de Passkey?
Revisa en este orden:
- compatibilidad del navegador y disponibilidad de Passkey
- precisión del reloj del sistema
- problemas de cross-origin o cabeceras de reverse proxy
No empieces sospechando de la base de datos. La mayoría de fallos de autenticación están relacionados con cliente o edge proxy.
¿Cuál es un script mínimo de aceptación en producción?
Usa este flujo repetible:
- Abre la home del frontend y registra la respuesta.
- Inicia sesión en admin y completa la configuración inicial.
- Crea y publica un elemento de contenido de prueba.
- Sube un archivo multimedia y verifica su recuperación.
- Confirma que el contenido publicado es visible en el frontend.
Esto valida rutas, autenticación, escritura, almacenamiento y lectura.
El despliegue parece correcto, pero falta contenido. ¿Por dónde empiezo?
Usa diagnóstico de ruta corta:
- Confirma que el elemento está publicado (no en borrador).
- Confirma que el frontend consulta la colección esperada.
- Revisa logs del runtime por errores de consulta o permisos.
La mayoría de incidentes de contenido faltante son problemas de estado o de ruta de consulta, no caídas de plataforma.
¿Cómo puede un equipo institucionalizar la calidad de aceptación?
Añade acciones de aceptación al flujo de release:
- pre-merge: ejecutar aceptación de tres capas en local o staging
- post-release: el ingeniero de guardia ejecuta el script mínimo en menos de 10 minutos
- post-incidente: agregar una nueva comprobación determinística para prevenir recurrencia
Los lanzamientos fiables vienen de controles de proceso, no de memoria tribal.
Fragmento de comandos de verificación
# Ejemplo de comprobaciones de runtime
curl -I https://your-site.workers.dev
curl -I https://your-site.workers.dev/_emdash/admin
npx wrangler tail your-worker-name