GitHub verbindet sich entweder über das Coroid GitHub App oder ein persönliches Zugriffstoken. Konfigurieren Sie es unter Einstellungen → Verbindungen → Quellcode-Verwaltung.
App oder Token
Die App ist die bessere Wahl. Sie gewährt Zugriff pro Repository statt pro Benutzer, funktioniert weiterhin, wenn der Einrichter das Unternehmen verlässt, und empfängt Webhook-Ereignisse ohne Abfragen.
Verwenden Sie ein Token, wenn die Installation der App eine Organisationsadministratorfreigabe erfordert, die Ihnen nicht möglich ist.
| GitHub App | Persönliches Zugriffstoken | |
|---|---|---|
| Zugriffsbereich | Pro Repository | Alles, was der Benutzer sehen kann |
| Bleibt auch nach dem Ausscheiden des Einrichters aktiv | Ja | Nein |
| Webhook-Ereignisse | Ja | Abfragen |
| Zuordnung | Die App | Der Token-Inhaber |
Installation der App
Wählen Sie GitHub unter Einstellungen → Verbindungen → Quellcode-Verwaltung aus und folgen Sie dem Installationsprozess. GitHub fragt nach den zu gewährenden Repositories; diese Einstellung können Sie später in den eigenen Einstellungen von GitHub ändern.
Wenn ein Repository beim Erstellen eines Projekts nicht angezeigt wird, wurde der App fast sicher nicht das spezifische Repository zugewiesen – das ist die häufigste Ursache.
Verwendung eines Tokens
Erstellen Sie ein klassisches Token mit dem repo Bereich oder ein feingranulares Token mit Lese- und Schreibrechten für Inhalte sowie Pull Requests, und fügen Sie es anschließend in die Einstellungen zur Versionsverwaltung ein.
Tokens werden ruhend verschlüsselt gespeichert, vom API nie zurückgegeben und nicht in Einstellungs-Exporte aufgenommen.
GitHub Issues
Die gleiche Verbindung ermöglicht das Importieren von Issues als Arbeitsaufgaben. Siehe Arbeitsaufgaben importieren.
Ereignisse, die zu Arbeitsaufgaben werden
Mit der App kann eine Ereignisautomatisierung ein pull request, ein neues Issue oder einen Kommentar erstellen, der Coroid in die Qualifikation erwähnt. Siehe Trigger und Zielorte.
Qualifizierte Arbeitsaufgaben aus diesen Ereignissen werden nur automatisch gestartet, wenn ihr Ersteller über Schreib-, Pflege- oder Administratorrechte für das Repository verfügt. Coroid fragt bei jedem Ereignis GitHub um Bestätigung. Bei einem pull request ist der Ersteller die Person, die es geöffnet hat, nicht diejenige, die es gekennzeichnet oder zusammengeführt hat. Arbeitsaufgaben von anderen Personen werden erstellt und warten darauf, dass jemand sie startet. Ein Kommentar, der Coroid erwähnt, zählt nur, wenn sein Autor Schreibrechte hat.
Pull Requests überprüfen
Mit der App prüft und bewertet Coroid Pull Requests, die von Menschen und anderen Tools erstellt wurden – nicht nur die eigenen Pull Requests von Coroid. Die Coroid Qualitätskontrolle führt die Projektprüfungen durch und gibt den Coroid Qualitätskontrolle-Check aus. Die Coroid Rezension gibt eine Bewertung mit Kommentaren zu den betroffenen Zeilen ab und erstellt einen Check namens Coroid Rezension. Beide Einstellungen finden Sie unter Qualitätskontrolle, im Bereich Pull Requests. Siehe Pull Requests.
Was Coroid in Ihrem Repository tut
- liest den Code, um ihn zu verstehen und zu ändern
- erstellt pro Aufgabe einen Branch
- pusht diesen Branch und öffnet einen pull request gegen Ihren Basisbranch
Es committet niemals direkt in Ihren Standardbranch oder führt ein Zusammenführen selbstständig durch. Ein Zusammenführen erfolgt nur, wenn eine Person den pull request in GitHub zusammenführt oder auf Genehmigen & zusammenführen in Coroid klickt.
Ein Projekt, das auf Nur lokal eingestellt ist, führt nur den ersten Schritt aus und nichts weiter: Coroid liest und holt Daten ab und speichert Branches, Bewertungen und Prüfungen innerhalb von Coroid. Es pusht nicht, öffnet keine Pull Requests oder gibt Kommentare ab, noch führt es Prüfläufe durch – selbst wenn die App oder das Token dies erlauben würden. Siehe Synchronisiert oder nur lokal.
Ihre Branch-Schutzregeln, erforderlichen Prüfungen und Revisionsregeln bleiben unverändert. Genehmigen & zusammenführen führt das Zusammenführen ebenfalls über pull request durch, sodass dieselben Regeln darüber entscheiden, ob es erfolgreich ist. Siehe Zusammenführen.
Sicherheit
Die Sicherheit nutzt die App, um den Coroid Security Check auszugeben und optional Sicherheitswarnungen von GitHub zu importieren sowie Merge-Warteschlangen zu überprüfen. Siehe GitHub-Berechtigungen und der Coroid Sicherheits-Check.