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).
Einen Anbieter verbinden
GitHub App oder ein Token
Einstellungen → Verbindungen → Versionskontrolle
Repositorys werden angezeigt
Diejenigen, auf die die Verbindung zugreifen kann
App-Zugriff oder Token-Berechtigung
Ein Projekt erstellen
Ein Projekt pro Repository
Projekte → Neu
Erste Analyse
Programmiersprachen, Erstell- und Testbefehle
Überprüfen Sie dies in den Projekteinstellungen.
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.
Coroid ohne Schreibzugriff auf Ihr Repository ausprobieren
Wählen Sie Nur lokal unter Repository-Modus , wenn Sie das Projekt erstellen. Coroid liest dann aus dem Repository und speichert jeden Branch, Commit und Review innerhalb von Coroid; es schreibt nie, hinterlässt keine Kommentare und öffnet keine Pull Requests. Wenn Sie Pull Requests benötigen, wählen Sie Synchronisierung starten in jeder Review oder in den Einstellungen des Projekts für das Repository. Siehe Synchronisiert oder nur lokal.
Ein öffentliches GitHub-Repository benötigt überhaupt keine Verbindung: wählen Sie Mit URL verbinden, fügen Sie die Repository-Adresse ein und überprüfen Sie den Zugriff. Ohne eine GitHub-Verbindung ist der Modus „Lokal“ vorausgewählt, da Coroid zwar ein öffentliches Repository lesen kann, aber nichts zum Einreichen von Pull Requests hat.
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.