Ciclo de vida de build y despliegue
El pipeline de build completo desde el git push hasta el sitio en producción: clonado, validación, subida a R2, revalidación ISR, monitoreo y estrategias de rollback.
Jamdesk gestiona el ciclo de vida completo de build y despliegue de forma automática. Haz push a GitHub y tu documentación quedará en línea en minutos.
Las capturas de pantalla muestran la interfaz en inglés.
Ciclo de vida del build
Disparadores del build
| Disparador | Cómo funciona | Caso de uso |
|---|---|---|
| Git Push | Webhook se activa 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 realizados en menos 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 despliega en Cloudflare R2. La mayoría de los sitios se compilan en 30-90 segundos.
Para 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 línea 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 lanzar builds manuales:
Rebuild manual
Lanza un build sin necesidad de hacer push de cambios:
- Ve a tu proyecto en el dashboard
- Abre Settings
- Haz clic en Rebuild
Úsalo cuando:
- Actualices variables de entorno
- Necesites corregir un build atascado
- Quieras actualizar tras cambios en la plataforma
Variables de entorno
Define variables en 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 se pueden referenciar en tus archivos docs.json o MDX.
Logs del build
Consulta los logs detallados del build para depuración:
- Ve a Deployments en tu proyecto
- Haz clic en un despliegue específico
- Visualiza el log completo del build
Los problemas más 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 quieres restaurar
- Haz clic en Rollback
La versión anterior queda en línea de inmediato mientras comienza un nuevo build.
Despliegues por rama
Los despliegues por rama están disponibles en los planes Pro.
Previsualiza los cambios antes de hacer merge:
- Haz push a una rama de funcionalidad
- Jamdesk crea un preview en
branch-name.your-project.jamdesk.app - Revisa y haz merge cuando estés listo