Coroid nécessite l'accès à un dépôt pour fonctionner. Vous connectez un fournisseur de Contrôle de source une fois au niveau de l'organisation, puis associez les dépôts individuels aux Projets.
Les Connexions sont gérées dans Paramètres → Connexions → Contrôle de source
(/settings/connections/source-control).
Fournisseurs pris en charge
| Fournisseur | Méthode de connexion | Disponibilité |
|---|---|---|
| GitHub | Installation de l'application GitHub, ou un jeton d'accès personnel | Disponible pour tous les utilisateurs |
| GitLab | Jeton d'accès personnel | Prévisualisation privée |
GitHub : Installation de l'application ou jeton
Pour GitHub, l'installation de l'application Coroid GitHub est la meilleure option. L'application accorde l'accès par dépôt plutôt que par utilisateur, continue de fonctionner même si la personne ayant effectué la configuration quitte l'entreprise, et permet à Coroid de recevoir des événements webhook sans avoir à interroger le système.
Optez pour un jeton d'accès personnel lorsque l'installation de l'application nécessite une approbation d'administrateur dont vous ne disposez pas.
Pour installer l'application, rendez-vous sur Paramètres → Connexions → Contrôle de source, sélectionnez GitHub, et suivez le processus d'installation. GitHub vous demandera quels dépôts accorder lui accès ; vous pourrez modifier cette configuration ultérieurement depuis les paramètres de GitHub.
Connexion via un jeton d'accès personnel
Créez le jeton dans votre fournisseur, puis collez-le dans Paramètres → Connexions → Contrôle de source.
Le jeton doit permettre de lire le contenu du dépôt ainsi que de créer des branches et des demandes de fusion. Sur GitHub, il s'agit du repo périmètre pour un jeton classique ; sur GitLab, il s'agit de api.
Les jetons sont chiffrés avant leur stockage et ne sont jamais renvoyés par API ni affichés à nouveau dans l'interface après leur enregistrement. Ils sont également exclus des paquets d'exportation de paramètres : un paquet exporté contient un espace réservé, et vous devez réentrer le secret lors de son importation ailleurs.
Associer un dépôt à un projet
Une connexion rend les dépôts disponibles ; un projet est l'environnement dans lequel Coroid travaille réellement. Créez-en un depuis Projets → Nouveau, sélectionnez le dépôt connecté, et Coroid effectuera une première analyse du code pour détecter les langages, les commandes de build et les commandes de test.
Cette première analyse permet à un agent de construire et de tester votre projet ; il est donc utile de vérifier le résultat. Vous pouvez corriger tout ce qui a été mal interprété dans les paramètres du projet.
Sur quelle branche Coroid travaille-t-il ?
Coroid se base sur votre branche par défaut et ouvre des demandes de fusion en retour vers celle-ci. Vous pouvez modifier la branche de base par projet dans les paramètres du dépôt si vous fusionnez vers autre chose que main.
Vérifier la connexion
La connexion fonctionne lorsque le dépôt apparaît dans la liste de création de projets et que la première analyse du projet est terminée. Si un dépôt attendu manque, les causes les plus fréquentes sont :
- l'application GitHub a été installée mais n'a pas reçu l'accès à ce dépôt spécifique
- le périmètre du jeton est trop restreint pour lister les dépôts privés
- le dépôt appartient à une organisation différente de celle que vous avez connectée
Suivant
Comment une tâche devient-elle une demande pull request ? — ce qui se passe après avoir décrit un travail.