Cycle de vie du build et du déploiement
Le pipeline de build complet, du git push au site en ligne : clonage, validation, upload vers R2, revalidation ISR, monitoring et stratégies de rollback.
Jamdesk gère automatiquement l'ensemble du cycle de vie de build et de déploiement. Il vous suffit d'effectuer un push sur GitHub pour déployer votre documentation en quelques minutes.
Les captures d'écran montrent l'interface en anglais.
Cycle de vie du build
Déclencheurs de build
| Déclencheur | Fonctionnement | Cas d'usage |
|---|---|---|
| Git Push | Le Webhook se déclenche lors d'un push sur la branche connectée | Développement normal |
| Dashboard | Cliquez sur « Rebuild » dans les paramètres du projet | Forcer une actualisation après des changements de configuration |
Les builds sont debounced. Plusieurs commits dans un intervalle de 10 secondes sont regroupés en un seul build.
Ce qui se passe pendant un build
Jamdesk clone votre repo, valide docs.json et la syntaxe MDX, compile en HTML optimisé avec indexation de recherche, avant de déployer sur Cloudflare R2. La plupart des sites sont buildés en 30 à 90 secondes.
Pour le détail complet du pipeline avec le diagramme d'architecture, consultez Comment fonctionne Jamdesk.
Statut de déploiement
Vérifiez le statut du build dans le dashboard :
| 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 |
La section Build History affiche les déploiements récents avec leur statut et permet de déclencher des rebuilds manuels :
Rebuild manuel
Déclenchez un rebuild sans pousser de changements :
- Accédez à votre projet dans le dashboard
- Ouvrez Settings
- Cliquez sur Rebuild
Utilisez cette option pour :
- Mettre à jour des variables d'environnement
- Résoudre un build bloqué
- Actualiser après des mises à jour de la plateforme
Variables d'environnement
Définissez les variables au moment du build dans Settings → Environment :
ANALYTICS_ID=G-XXXXXXXXXX
API_BASE_URL=https://api.example.comLes variables sont disponibles pendant le processus de build et peuvent être référencées dans votre docs.json ou vos fichiers MDX.
Logs de build
Consultez les logs de build détaillés pour le débogage :
- Accédez à Deployments dans votre projet
- Cliquez sur un déploiement spécifique
- Consultez le log de build complet
Les problèmes courants apparaissent dans les logs :
- Syntaxe MDX invalide
- Images ou assets manquants
- Liens internes cassés
- Erreurs de configuration
Rollbacks
Revenez à une version précédente :
- Accédez à Deployments
- Trouvez le déploiement que vous souhaitez restaurer
- Cliquez sur Rollback
La version précédente est déployée immédiatement pendant qu'un nouveau build démarre.
Déploiements de branche
Les déploiements de branche sont disponibles sur les plans Pro.
Prévisualisez les changements avant de fusionner :
- Effectuez un push sur une branche de fonctionnalité
- Jamdesk crée une preview à
branch-name.your-project.jamdesk.app - Consultez puis fusionnez lorsque vous êtes prêt