GitHub se connecte soit via Coroid Application GitHub ou un jeton d'accès personnel. Configurez-le dans Paramètres → Connexions → Contrôle de source.
Application ou jeton
Privilégiez l'application. Elle accorde un accès par dépôt plutôt qu'au niveau utilisateur, continue de fonctionner même si la personne ayant effectué la configuration quitte l'entreprise, et reçoit les événements webhook sans avoir besoin de sondages.
Utilisez un jeton lorsque l'installation de l'application nécessite une approbation d'administrateur d'organisation que vous ne pouvez pas obtenir.
| Application GitHub | Jeton d'accès personnel | |
|---|---|---|
| Portée d'accès | Par dépôt | Tout ce que l'utilisateur peut voir |
| Continue de fonctionner après le départ de l'installateur | Oui | Non |
| Événements webhook | Oui | Sondage |
| Attribution | L'application | Le propriétaire du jeton |
Installation de l'application
Sélectionnez GitHub dans Paramètres → Connexions → Contrôle de source et suivez le processus d'installation. GitHub vous demandera quels dépôts accorder ; vous pourrez modifier cela ultérieurement depuis les paramètres propres à GitHub.
Si un dépôt n'apparaît pas lors de la création d'un projet, il est très probable que l'application n'ait pas été autorisée pour ce dépôt spécifique – c'est de loin la cause la plus fréquente.
Utilisation d'un jeton
Créez un jeton classique avec la repo portée, ou un jeton granulé avec des droits de lecture et d'écriture sur les contenus et les demandes de fusion, puis collez-le dans les paramètres du contrôle de source.
Les jetons sont chiffrés au repos, jamais renvoyés par API, et jamais inclus dans les exports de paramètres.
Problèmes GitHub
La même connexion permet d'importer les problèmes en tant que tâches. Consultez Importation de tâches.
Ce que Coroid fait dans votre dépôt
- lit le code pour le comprendre et le modifier
- crée une branche par tâche
- pousse cette branche et ouvre une demande de fusion pull request vers votre branche de base
Il ne commite jamais dans votre branche par défaut et ne la fusionne jamais. Vos règles de protection de branche, de vérifications requises et de révision s'appliquent sans changement.