Hilfezentrum · Erste Schritte

Wie verbinde ich mein GitLab- oder GitHub-Repository mit Diavi?

Ein Zugriffstoken erstellen, sich anmelden und das Repository wählen, an dem Diavi arbeitet.

Diavi verbindet sich mit Ihrer Forge über Ihr eigenes persönliches Zugriffstoken — ein Diavi-Passwort gibt es nicht. Sie erzeugen ein Token in GitLab oder GitHub, fügen es bei der Anmeldung ein, und Diavi arbeitet unter Ihrer Identität, mit genau den Rechten, die dieses Token trägt.

Welche Rechte braucht das Token?

Das Minimum, damit die Pipeline ein Issue lesen, das Repository klonen und einen Merge Request öffnen kann.

• GitLab: die Scopes api und read_user.
• GitHub: der Scope repo.

Erstellen Sie es in den Einstellungen Ihres Kontos, unter Access Tokens (GitLab) oder Developer settings → Personal access tokens (GitHub).

Wo füge ich es ein?

Auf der Anmeldeseite, zusammen mit der Kennung Ihres Arbeitsbereichs. Nutzt Ihr Team eine selbst gehostete Instanz, klappen Sie das optionale Feld auf und geben deren URL an — sie muss https:// sein, niemals http://: ein unverschlüsselt gesendetes Token quert das Internet im Klartext, und Diavi weigert sich, es zu speichern.

Kann jemand mein Token wieder auslesen?

Nein, und das ist Absicht. Es wird verschlüsselt gespeichert und von keiner Oberfläche erneut angezeigt — weder Ihrer noch der Konsole des Herstellers. Verlieren Sie es, erzeugen Sie ein neues in Ihrer Forge und ersetzen es in Ihren Einstellungen; es gibt keine Wiederherstellung, nur einen Austausch.

Wie wechsle ich das Token später?

Über Pipeline → Ausführung, dem Kontoinhaber vorbehalten. Das neue Token wird vor dem Speichern gegen Ihre Forge geprüft: ist es abgelaufen oder fehlt ein Scope, erfahren Sie es sofort und nicht erst beim ersten fehlgeschlagenen Lauf.

Und danach?

Nach der Anmeldung sieht Diavi die Projekte, zu denen Ihr Token Zugang gibt. Auf welchem Sie einen Lauf starten, wählen Sie beim Start — nichts ist auf ein einzelnes Repository festgelegt.