Ciclo de vida de build y despliegue
El pipeline de build completo, de git push a sitio en vivo: clone, validación, subida a R2, revalidación ISR, monitoreo y estrategias de rollback.
Jamdesk gestiona automáticamente todo el ciclo de vida de build y despliegue. Haz push a GitHub y tu documentación estará en vivo en minutos.
Las capturas de pantalla muestran la interfaz en inglés.
Ciclo de vida del build
Disparadores de build
| Disparador | Cómo funciona | Caso de uso |
|---|---|---|
| Git Push | El Webhook se dispara al hacer push a la rama conectada | Desarrollo normal |
| Dashboard | Haz clic en "Rebuild" en la configuración del proyecto | Forzar actualización tras cambios de configuración |
Los builds tienen debounce. Varios commits dentro de 10 segundos se agrupan en un único build.
Qué ocurre durante un build
Jamdesk clona tu repositorio, valida docs.json y la sintaxis MDX, compila a HTML optimizado con indexación de búsqueda y luego procede a desplegar el sitio en Cloudflare R2. La mayoría de los sitios se compilan en 30-90 segundos.
Para ver el desglose completo del pipeline con diagrama de arquitectura, consulta Cómo funciona Jamdesk.
Estado del despliegue
Consulta el estado del build en el dashboard:
| Estado | Significado |
|---|---|
| Building | Build en progreso |
| Deployed | En vivo en tu dominio |
| Failed | Error de build - revisa los logs |
| Queued | Esperando el build anterior |
La sección Build History muestra los despliegues recientes con su estado y la posibilidad de activar rebuilds manuales:
Rebuild manual
Activa un rebuild sin hacer push de cambios:
- Ve a tu proyecto en el dashboard
- Abre Settings
- Haz clic en Rebuild
Usa esto cuando:
- Actualices variables de entorno
- Soluciones un build atascado
- Actualices después de mejoras de la plataforma
Variables de entorno
Configura variables de tiempo de build en Settings → Environment:
ANALYTICS_ID=G-XXXXXXXXXX
API_BASE_URL=https://api.example.comLas variables están disponibles durante el proceso de build y pueden referenciarse en tu docs.json o archivos MDX.
Logs de build
Consulta los logs detallados del build para depuración:
- Ve a Deployments en tu proyecto
- Haz clic en un despliegue específico
- Consulta el log completo del build
Los problemas comunes aparecen en los logs:
- Sintaxis MDX inválida
- Imágenes o assets faltantes
- Enlaces internos rotos
- Errores de configuración
Rollbacks
Revierte a una versión anterior:
- Ve a Deployments
- Encuentra el despliegue que deseas restaurar
- Haz clic en Rollback
La versión anterior vuelve a estar en vivo de inmediato, mientras Jamdesk empieza a desplegar el nuevo build.
Despliegues de rama
Los despliegues de rama están disponibles en los planes Pro.
Previsualiza cambios antes de fusionarlos:
- Haz push a una rama de feature
- Jamdesk crea una preview en
branch-name.your-project.jamdesk.app - Revisa y fusiona cuando esté listo