GitLab verbindet sich mithilfe eines persönlichen Zugriffstokens. Konfigurieren Sie es unter Einstellungen → Verbindungen → Quellcode-Verwaltung.
Erstellung des Tokens
Erstellen Sie in GitLab ein persönliches Zugriffstoken mit dem api entsprechenden Berechtigungsumfang. Dieser umfasst das Lesen von Repository-Inhalten, das Erstellen von Branches und das Öffnen von Merge Requests.
Fügen Sie das Token in die Einstellungen der Quellcode-Verwaltung ein. Coroid verschlüsselt es bei der Speicherung, gibt es niemals über die Oberfläche oder API zurück und enthält es auch nicht in Exporten der Einstellungen.
Eigentümerschaft des Tokens
Für die gemeinsame Nutzung im Team erstellen Sie das Token auf einem Konto, das für Automatisierungen vorgesehen ist – nicht auf einem individuellen Konto – damit die Verbindung auch bei Rollenwechseln weiterhin besteht.
Legen Sie ein Ablaufdatum fest, das Sie tatsächlich überwachen. Ein veraltetes Token, das unbemerkt abläuft, führt dazu, dass der Push-Vorgang plötzlich fehlschlägt – ein verwirrendes Symptom, das allein anhand der Fehlermeldung schwer zu diagnostizieren ist.
Merge Requests
Coroid öffnet Merge Requests genauso wie Pull Requests auf GitHub – je Aufgabe ein Branch, der beim Abschluss der Arbeit gepusht wird und auf Ihren Basis-Branch ausgerichtet ist.
Coroid führt keine Merges eigenständig durch. Ein Merge erfolgt nur, wenn eine Person den Merge Request in GitLab zusammenführt oder auf Genehmigen & zusammenführen in Coroid klickt.
Ihre bestehenden Genehmigungsregeln und Pipelines-Anforderungen bleiben unverändert beibehalten. Genehmigen & zusammenführen führt den Merge ebenfalls über den Merge Request durch; somit entscheiden dieselben Regeln darüber, ob der Vorgang erfolgreich ist. Weitere Informationen finden Sie unter Zusammenführen.
GitLab Review Apps
Wenn Sie GitLab Review Apps nutzen, können diese Umgebungen als Rezensionsnachweise zu Merge Requests hinzugefügt werden. Weitere Details finden Sie unter Rezensionsnachweise.
Selbst gehostetes GitLab
Die Verbindung setzt voraus, dass Ihre GitLab-Instanz von Coroid aus erreichbar ist. Bei einer selbst gehosteten Instanz hinter einer Netzwerkgrenze müssen Sie dies vor der Verwendung des Tokens klären.