Jamdesk Documentation logo

Votre premier build

Ce qui se passe après la connexion d'un dépôt — phases de build, onglet Déploiements et points à vérifier en cas d'échec.

Votre premier build démarre automatiquement dès que vous connectez un dépôt.

Builds automatiques

Lorsque vous connectez un dépôt, Jamdesk déclenche immédiatement un build initial. Chaque push suivant vers votre branche connectée déclenche automatiquement un nouveau build.

Progression du build

Suivez votre build dans le dashboard :

1
En attente

Votre build est en attente de démarrage. Aux heures de pointe, il peut y avoir un court délai.

2
Clonage

Jamdesk récupère le contenu de votre dépôt depuis GitHub.

3
Validation

Votre docs.json et vos fichiers MDX sont validés pour détecter les erreurs.

4
Build en cours

Le MDX est compilé en HTML optimisé avec coloration syntaxique et indexation de la recherche.

5
Déploiement

Les fichiers générés sont envoyés vers le CDN mondial.

6
En ligne

Votre documentation est disponible à l'URL de votre projet.

Consulter votre documentation en ligne

Une fois le build terminé, cliquez sur Voir le site dans le dashboard ou rendez-vous sur https://your-project.jamdesk.app.

Si vous avez configuré un domaine personnalisé, votre documentation y sera également disponible.

Rebuild manuel

Besoin de relancer un build sans pousser de modifications ?

  1. Accédez à votre projet dans le dashboard
  2. Ouvrez Paramètres
  3. Cliquez sur Reconstruire

Utilisez cette option après avoir modifié des variables d'environnement ou pour forcer un build complet.

En cas d'échec du build

Les échecs de build affichent un message d'erreur dans le dashboard. Causes fréquentes :

  • Syntaxe docs.json invalide
  • Erreurs de syntaxe MDX
  • Pages manquantes référencées dans la navigation
Référence des erreurs de build

Consultez les codes d'erreur courants et comment les corriger

Articles associés

Déclencher des builds

En savoir plus sur les déclencheurs de build automatiques et manuels

Surveiller les builds

Suivre la progression des builds et consulter les journaux