Hilfezentrum · Erste Schritte

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

Mit der Forge anmelden, dem Bereich Zugriff auf die Repositories geben und das Repository wählen, an dem Diavi arbeitet.

Klicken Sie auf Weiter mit GitLab oder Weiter mit GitHub: Ihre Forge bestätigt, wer Sie sind, ohne dass ein Passwort anzulegen wäre. Der Zugriff auf die Repositories läuft über das Token des Bereichs, das der Inhaber einmal hinterlegt; jedes Mitglied arbeitet danach damit, ohne sein eigenes anzugeben.

Wie melde ich mich an?

• Mit Ihrer Forge (empfohlen): ein Klick, und GitLab oder GitHub bestätigt Ihre Identität. Für eine selbst gehostete GitLab-Instanz klappen Sie das optionale Feld auf und geben deren URL an, mit https://.
• Mit E-Mail-Adresse und Passwort: festzulegen unter Einstellungen → Anmeldung und Sicherheit, nachdem Sie sich einmal mit Ihrer Forge angemeldet haben. Praktisch dort, wo die Forge nicht für alle offen ist.
• Mit einem persönlichen Token: nur, solange Ihre Instanz noch keine Anmelde-Anwendung hinterlegt hat. Es belegt Ihre Identität einmal und wird danach nicht aufbewahrt.

Welche Rechte braucht das Token des Bereichs?

Das Minimum, um ein Issue zu lesen, das Repository zu klonen und einen Merge Request zu öffnen.

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

Es wird unter Einstellungen → Forge hinterlegt und 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 Run.

Kann jemand das Token wieder auslesen?

Nein, und das ist Absicht. Es ist in der Datenbank verschlüsselt, und keine Oberfläche zeigt es erneut an — weder Ihre noch die Konsole von Diavi. Wenn Sie es verlieren, erzeugen Sie auf Ihrer Forge ein neues und ersetzen es; es gibt keine Wiederherstellung, nur einen Austausch. Diavi warnt Sie, wenn es das von Ihnen festgelegte Alter erreicht, und sobald die Forge es ablehnt.

Und wenn die Person geht, die das Token hinterlegt hat?

Mit einem persönlichen Token hängt der Bereich von dieser Person ab: Verlässt sie das Team oder läuft ihr Token ab, stoppen die Runs. Hinterlegen Sie auf GitLab besser ein Gruppen-Zugriffstoken (oder Projekt-Token): Es handelt im Namen eines Bots, der niemandem gehört, und Diavi erkennt es selbst — der Bildschirm zeigt „Token des Bots“. Installieren Sie auf GitHub die Diavi-Anwendung in Ihrer Organisation unter Einstellungen → Forge, sobald sie angeboten wird: Ihr Token erneuert sich selbst. Anmeldungen von Mitgliedern ersetzen keines von beiden.

Und danach?

Nach der Anmeldung sieht Diavi die Projekte, auf die das Token des Bereichs Zugriff gibt. Sie wählen beim Start, auf welchem Sie einen Run starten — nichts ist auf ein einziges Repository festgelegt.