Workflow de déploiement
Découvrez comment Jamdesk automatise le déploiement via GitHub ou la CLI, avec suivi du statut, rebuilds manuels, logs de build et rollbacks.
Jamdesk gère le déploiement automatiquement. Poussez vers votre branche GitHub connectée et votre documentation est mise en ligne en quelques minutes.
Déploiement CLI
Vous pouvez également déployer directement depuis le terminal sans pousser vers GitHub. C'est utile pour les itérations rapides, tester des modifications, ou les projets non connectés à un dépôt.
jamdesk login # First time only
jamdesk deployLa CLI empaquette vos fichiers, les téléverse et affiche la progression du build en direct. Utilisez --detach pour mettre le build en file d'attente et quitter immédiatement.
Le workflow
Modifiez vos fichiers MDX et faites un preview avec jamdesk dev.
Commitez et poussez vers votre branche connectée :
git add .
git commit -m "Update authentication docs"
git pushJamdesk détecte votre push, effectue le build de votre documentation et la déploie sur le CDN. La plupart des sites sont prêts en 30 à 90 secondes.
Statut de déploiement
Vérifiez le statut dans le dashboard sous Deployments :
| Statut | Signification |
|---|---|
| Building | Build en cours |
| Deployed | En ligne sur votre domaine |
| Failed | Erreur de build - consultez les logs |
| Queued | En attente du build précédent |
Rebuild manuel
Déclenchez un rebuild sans pousser :
- Allez dans Settings de votre projet
- Cliquez sur Rebuild
Utilisez cette option lors de la mise à jour de variables d'environnement ou pour corriger des builds bloqués.
Logs de build
En cas d'échec de build, consultez Deployments → cliquez sur un déploiement → affichez les logs. Problèmes courants :
- Syntaxe MDX invalide
- Images manquantes
- Liens internes cassés
- Erreurs de configuration
Rollbacks
Revenez à une version précédente :
- Allez dans Deployments
- Trouvez le déploiement à restaurer
- Cliquez sur Rollback
La version précédente est mise en ligne immédiatement.