Coroid benötigt vor der Nutzung Zugriff auf ein Repository. Sie verbinden einen Anbieter für die Quellcode-Verwaltung einmal auf Organisationsebene und weisen anschließend einzelne Repositorys den Projekten zu.
Die Verbindungen werden unter Einstellungen → Verbindungen → Quellcode-Verwaltung
(/settings/connections/source-control).
Unterstützte Anbieter
| Anbieter | Verbindungsmethode | Verfügbarkeit |
|---|---|---|
| GitHub | GitHub: App-Installation oder persönliches Zugriffstoken | Allgemein verfügbar |
| GitLab | Persönliches Zugriffstoken | Private Vorschau |
GitHub: App-Installation oder Token
Für GitHub ist die Installation der Coroid GitHub-App die bessere Wahl. Die App gewährt Zugriff pro Repository statt pro Benutzer, funktioniert weiterhin, wenn die einrichtende Person das Unternehmen verlässt, und ermöglicht es Coroid, Webhook-Ereignisse ohne Polling zu empfangen.
Wählen Sie stattdessen ein persönliches Zugriffstoken, wenn die App-Installation eine Administratorfreigabe erfordert, die Ihnen nicht zur Verfügung steht.
Um die App zu installieren, gehen Sie zu Einstellungen → Verbindungen → Quellcode-Verwaltung, wählen Sie GitHub, und folgen Sie dem Installationsablauf. GitHub fragt nach den Repositorys, denen der Zugriff gewährt werden soll; diese Einstellung können Sie später in den Einstellungen von GitHub ändern.
Verbindung über ein persönliches Zugriffstoken
Erstellen Sie das Token beim jeweiligen Anbieter und fügen Sie es anschließend unter Einstellungen → Verbindungen → Quellcode-Verwaltung.
Das Token muss den Inhalt des Repositorys lesen sowie Branches und Pull Requests erstellen können. Bei GitHub handelt es sich dabei um das repo Bereich für ein klassisches Token; bei GitLab ist es api.
Tokens werden vor der Speicherung verschlüsselt und weder von API zurückgegeben noch nach dem Speichern in der Oberfläche angezeigt. Sie werden außerdem von Exportpaketen der Einstellungen ausgeschlossen – ein exportiertes Paket enthält einen Platzhalter, und Sie müssen das Geheimnis beim Import an einem anderen Ort erneut eingeben.
Ein Repository einem Projekt zuordnen
Eine Verbindung macht Repositorys verfügbar; ein Projekt ist jedoch der Arbeitsbereich von Coroid. Erstellen Sie eines unter Projekte → Neu, wählen Sie das verknüpfte Repository aus, und Coroid führt eine erste Analyse des Codebases durch, um Programmiersprachen, Build-Befehle und Testbefehle zu erkennen.
Diese erste Analyse ermöglicht es einem Agenten, Ihr Projekt zu erstellen und zu testen – daher lohnt es sich, das Ergebnis zu überprüfen. Sie können falsch erkannte Angaben unter den Einstellungen des Projekts korrigieren.
Aus welchem Branch Coroid arbeitet
Coroid arbeitet vom Standardbranch aus und öffnet Pull Requests gegen diesen Branch. Sie können den Basisbranch pro Projekt in den Repository-Einstellungen des Projekts ändern, falls etwas anderes als main.
Die Verbindung überprüfen
Die Verbindung funktioniert, wenn das Repository in der Liste zur Projekterstellung erscheint und die erste Analyse des Projekts abgeschlossen ist. Wenn ein erwartetes Repository fehlt, liegen die häufigsten Ursachen vor:
- die GitHub-App wurde installiert, erhielt aber keinen Zugriff auf dieses spezielle Repository
- der Bereich des Tokens ist zu eingeschränkt, um private Repositorys aufzulisten
- das Repository gehört zu einer anderen Organisation als der, mit der Sie die Verbindung hergestellt haben
Weiter
Wie aus einer Aufgabe ein pull request wird – was nach der Beschreibung der Arbeit geschieht.