Problèmes GitHub
Résolvez les organisations manquantes lors de la configuration, les dépôts manquants, les webhooks en échec, les erreurs de permissions et les désaccords de branches avec l'intégration GitHub de Jamdesk.
La plupart des problèmes d'intégration GitHub sont liés aux permissions, aux échecs de Webhook ou aux désaccords de branches.
Organisation non affichée lors de la configuration
Lors du flux de configuration des docs de démarrage, Jamdesk affiche vos organisations GitHub afin que vous puissiez choisir où créer le dépôt. Si votre organisation n'apparaît pas dans la liste, c'est généralement pour l'une des deux raisons suivantes :
- Restrictions de l'application OAuth : votre organisation restreint l'accès aux applications tierces (comportement par défaut de GitHub pour les nouvelles organisations).
- SAML SSO : votre organisation exige une authentification SAML avant que l'API la renvoie.
Les administrateurs d'organisation peuvent accorder l'accès à Jamdesk :
- Accédez aux Paramètres de votre organisation GitHub
- Sélectionnez Accès tiers (sous Sécurité)
- Trouvez Jamdesk dans les requêtes en attente, ou cliquez sur Accorder pour l'approuver
- Revenez au flux de configuration Jamdesk ; votre organisation devrait maintenant apparaître
Si vous ne voyez pas de requête en attente, lancez d'abord le flux de configuration Jamdesk. GitHub envoie automatiquement une requête d'accès à vos administrateurs d'organisation lorsque vous autorisez l'application. Consultez le guide GitHub sur l'approbation des applications OAuth pour votre organisation pour des étapes détaillées.
Vous ne souhaitez pas attendre l'approbation d'un administrateur ? Sélectionnez votre compte personnel lors de la configuration et transférez le dépôt vers votre organisation ensuite :
- Terminez la configuration Jamdesk en utilisant votre compte personnel
- Accédez au dépôt créé sur GitHub
- Naviguez vers Paramètres → Général → Zone dangereuse
- Cliquez sur Transférer et sélectionnez votre organisation comme destination
- Dans Jamdesk, déconnectez puis reconnectez le dépôt depuis la page Paramètres de votre projet
La déconnexion et la reconnexion génèrent une nouvelle URL de documentation (par exemple, your-project.jamdesk.app peut changer). Si vous avez déjà partagé votre URL ou configuré un domaine personnalisé, contactez le support avant de déconnecter afin que nous puissions préserver votre configuration.
Dépôt non visible
Si votre dépôt n'apparaît pas dans la liste :
- Accédez à GitHub → Paramètres → Applications → Jamdesk
- Vérifiez que l'accès au dépôt est accordé
- Cliquez sur Configurer pour ajouter d'autres dépôts
Pour les dépôts d'organisation :
- Un administrateur de l'organisation doit approuver Jamdesk
- Accédez aux paramètres de l'organisation → Accès tiers
- Approuvez la requête d'accès de Jamdesk
Les dépôts privés nécessitent une autorisation GitHub. Réautorisez Jamdesk si nécessaire.
Builds non déclenchés
Si les pushs ne déclenchent pas de builds :
- Accédez à votre dépôt sur GitHub
- Naviguez vers Paramètres → Webhooks
- Trouvez le webhook Jamdesk
- Vérifiez les « Livraisons récentes » pour détecter des erreurs
Les builds se déclenchent uniquement sur votre branche configurée. Vérifiez les Paramètres dans Jamdesk.
- Accédez aux Paramètres du projet dans Jamdesk
- Cliquez sur Resynchroniser GitHub
Erreurs de Webhook
404 Not Found
L'endpoint du Webhook est inaccessible.
Correction : Resynchronisez la connexion GitHub dans les paramètres du projet.
401 Unauthorized
L'authentification a échoué.
Correction :
- Accédez aux paramètres de votre compte GitHub
- Naviguez vers Applications → Applications OAuth autorisées
- Révoquez Jamdesk
- Réautorisez dans les paramètres Jamdesk
500 Server Error
Problème temporaire côté Jamdesk.
Correction : Attendez quelques minutes et poussez à nouveau, ou déclenchez un rebuild manuel.
Erreurs de permissions
« Repository not found » lors du build :
- Le dépôt a peut-être été supprimé ou renommé
- Jamdesk a peut-être perdu l'accès
- Réautorisez votre connexion GitHub
Problèmes de branches
Mauvaise branche en cours de build
Vérifiez votre branche configurée dans Paramètres → Dépôt.
Branche renommée ou supprimée
Mettez à jour votre paramètre de branche pour correspondre au nouveau nom de branche.