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).
Connecter un fournisseur
Application GitHub ou un jeton
Paramètres → Connexions → Contrôle de version
Les dépôts apparaissent
Ceux auxquels la connexion peut accéder
Accès à l'application ou portée du jeton
Créer un projet
Un projet par dépôt
Projets → Nouveau
Première analyse
Langages, commandes de compilation et de test
Vérifiez-le dans les paramètres du projet
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.
Essayer Coroid sans écrire dans votre dépôt
Sélectionnez Local only sous Mode de dépôt lors de la création du projet. Coroid lira alors depuis le dépôt et conservera toutes les branches, commits et revues à l'intérieur de Coroid ; il n'écrira jamais, ne commentera pas et n'ouvrira pas de demandes de fusion. Si vous souhaitez des demandes de fusion, choisissez Démarrer la synchronisation sur toute revue ou dans les paramètres du dépôt du projet. Consultez Synchronisé ou local only.
Un dépôt public GitHub n'a pas besoin de connexion : sélectionnez Se connecter avec l'URL, collez l'adresse du dépôt et validez l'accès. Sans connexion GitHub, l'option « Local uniquement » est pré-sélectionnée, car Coroid peut lire un dépôt public mais n'a rien à y pousser.
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.