GitHub verbindet entweder über die Coroid GitHub App oder ein persönliches Zugriffstoken. Konfigurieren Sie es unter Einstellungen → Verbindungen → Quellcode-Verwaltung.
App oder Token
Die App ist die bevorzugte Option. Sie gewährt Zugriff pro Repository statt pro Benutzer, funktioniert weiter, selbst wenn die einrichtende Person das Unternehmen verlässt, und empfängt Webhook-Ereignisse ohne Polling.
Ein Token sollten Sie nutzen, 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 Installateurs aktiv | Ja | Nein |
| Webhook-Ereignisse | Ja | Polling |
| 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 auch in den eigenen Einstellungen von GitHub ändern.
Falls ein Repository beim Erstellen eines Projekts nicht angezeigt wird, wurde der App fast sicher nicht das jeweilige Repository zugewiesen – das ist die häufigste Ursache.
Nutzung 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 Quellcode-Verwaltung ein.
Tokens werden im Ruhezustand verschlüsselt gespeichert, vom API nie zurückgegeben und auch nicht in Einstellungs-Exports aufgeführt.
GitHub Issues
Dieselbe Verbindung ermöglicht das Importieren von Issues als Aufgaben. Weitere Informationen finden Sie unter Aufgaben importieren.
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 Basis-Branch
Es committet niemals direkt in Ihren Standard-Branch und führt auch keine Merges durch. Ihre Branch-Schutzregeln, erforderlichen Prüfungen und Review-Regeln bleiben unverändert.