Ciclo de vida de build y despliegue
El pipeline de build completo desde git push hasta el sitio en vivo — clonar, validar, subir a R2, revalidación ISR, monitoreo y estrategias de rollback.
Jamdesk gestiona automáticamente el ciclo de vida completo de build y despliegue. Haz push a GitHub y Jamdesk se encarga de desplegar tu documentación en minutos.
Las capturas de pantalla muestran la interfaz en inglés.
Nota: Las capturas de pantalla en esta página muestran la interfaz en inglés. La interfaz del dashboard está disponible únicamente en inglés por el momento.
Ciclo de vida del build
Disparadores de build
| Disparador | Cómo funciona | Caso de uso |
|---|---|---|
| Git Push | El 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. Los commits múltiples 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 despliega en Cloudflare R2. La mayoría de los sitios se construyen 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 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
Ú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.com
Las variables están disponibles durante el proceso de build y pueden referenciarse en tus archivos docs.json o 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
- Visualiza 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 queda en vivo de inmediato mientras comienza un nuevo build.
Despliegues por rama
Los despliegues por rama están disponibles en los planes Pro.
Preview de cambios antes de fusionar:
- Haz push a una rama de funcionalidad
- Jamdesk crea una preview en
branch-name.your-project.jamdesk.app - Revisa y fusiona cuando esté listo