Workflow de déploiement
Poussez vers GitHub et votre documentation se déploie automatiquement -- le workflow des modifications locales à un site en ligne en quelques minutes.
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 via 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 deployLe CLI empaquette vos fichiers, les télécharge 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 prévisualisez 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, build votre documentation et la déploie sur le CDN. La plupart des sites se buildent 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
Revenir à 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.