Flujo de trabajo de despliegue
Haz push a GitHub y tu documentación se despliega automáticamente -- el flujo de trabajo desde ediciones locales hasta un sitio en vivo en minutos.
Jamdesk gestiona el despliegue automáticamente. Haz push a tu rama de GitHub conectada y tu documentación estará en vivo en minutos.
Despliegue con CLI
También puedes desplegar directamente desde el terminal sin hacer push a GitHub. Esto es útil para iteraciones rápidas, pruebas de cambios, o proyectos no conectados a un repositorio.
jamdesk login # First time only
jamdesk deployEl CLI empaqueta tus archivos, los sube y muestra el progreso del build en vivo. Usa --detach para poner el build en cola y salir inmediatamente.
El flujo de trabajo
Edita tus archivos MDX y previsualiza con jamdesk dev.
Confirma y haz push a tu rama conectada:
git add .
git commit -m "Update authentication docs"
git pushJamdesk detecta tu push, construye tu documentación y la despliega en el CDN. La mayoría de los sitios se construyen en 30-90 segundos.
Estado del despliegue
Verifica el estado en el dashboard bajo Deployments:
| Estado | Significado |
|---|---|
| Building | Build en progreso |
| Deployed | En vivo en tu dominio |
| Failed | Error de build - verifica los logs |
| Queued | Esperando el build anterior |
Reconstrucción manual
Activa una reconstrucción sin hacer push:
- Ve a Settings en tu proyecto
- Haz clic en Rebuild
Úsalo cuando actualices variables de entorno o corrijas builds atascados.
Logs de build
Cuando los builds fallan, revisa Deployments → haz clic en un despliegue → visualiza los logs. Problemas comunes:
- Sintaxis MDX inválida
- Imágenes faltantes
- Enlaces internos rotos
- Errores de configuración
Reversiones
Vuelve a una versión anterior:
- Ve a Deployments
- Encuentra el despliegue a restaurar
- Haz clic en Rollback
La versión anterior queda en vivo inmediatamente.