---
title: Ciclo de vida de build y despliegue
description: "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

```mermaid
flowchart TD
    A["Git Push"] -->|webhook| B["Build Triggered"]
    C["Manual Rebuild"] --> B

    B --> E{"Validation"}
    E -->|pass| F["Build & Compile"]
    E -->|fail| G["Error in Dashboard"]

    F --> H["Deploy to CDN"]
    H --> I["Cache Purge"]
    I --> J["Live on Edge"]

    G -->|"fix & retry"| A
```

## 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 |

<Note>
Los builds tienen debounce. Varios commits realizados en menos de 10 segundos se agrupan en un único build.
</Note>

## 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](/es/how-jamdesk-works).

## 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:

<SizedImage src="/images/dashboard/build-history.webp" alt="Build History showing recent deployments with Successful status badges, commit info, and Rebuild button" />

## Rebuild manual

Lanza un build sin necesidad de hacer push de cambios:

1. Ve a tu proyecto en el dashboard
2. Abre **Settings**
3. 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**:

```bash
ANALYTICS_ID=G-XXXXXXXXXX
API_BASE_URL=https://api.example.com
```

Las 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:

1. Ve a **Deployments** en tu proyecto
2. Haz clic en un despliegue específico
3. 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:

1. Ve a **Deployments**
2. Encuentra el despliegue que quieres restaurar
3. Haz clic en **Rollback**

La versión anterior queda en línea de inmediato mientras comienza un nuevo build.

## Despliegues por rama

<Note>
Los despliegues por rama están disponibles en los planes Pro.
</Note>

Previsualiza los cambios antes de hacer merge:

1. Haz push a una rama de funcionalidad
2. Jamdesk crea un preview en `branch-name.your-project.jamdesk.app`
3. Revisa y haz merge cuando estés listo

## ¿Qué sigue?

<Columns cols={2}>
  <Card title="Descripción general del despliegue" icon="cloud-arrow-up" href="/es/deploy/overview">
    Elige entre subdominio, dominio personalizado u hosting en subruta
  </Card>
  <Card title="Hosting en subruta" icon="route" href="/es/deploy/subpath-hosting">
    Aloja la documentación en example.com/docs
  </Card>
</Columns>