Logo

GitLab-Host und Token konfigurieren

Orientierung und Setup

GitLab-Host und Token konfigurieren

In dieser Lektion verbinden Sie Divekit mit dem GitLab-Host, der später in Ihrer Distributionskonfiguration auftaucht.

Ihre Distributionskonfiguration verweist später über das Feld remote in config.json auf einen Host-Alias.

Divekit braucht dafür:

  • eine konfigurierte GitLab-Instanz
  • einen Token für diesen Host

Interaktives Setup

Führen Sie aus:

# Interaktives Host- und Token-Setup starten
divekit auth

Im normalen Kurs-Setup steht gitnrw bereits in der Instanzliste.
Wählen Sie diese Instanz und erstellen oder fügen Sie einen Personal Access Token mit dem Scope api ein, wenn die CLI danach fragt.

Wichtig für Einsteiger*innen ist:

  • die richtige Instanz wählen
  • den Token einfügen, wenn danach gefragt wird (Rechtsklick & Einfügen funktioniert in den meisten Terminals)
  • Divekit den Token validieren lassen

So sieht der Prompt-Ablauf aus

Ein typischer interaktiver Ablauf sieht ungefähr so aus:

Select an instance:

●    gitnrw https://gitlab.git.nrw/
○    Register new instance...

Create a Personal Access Token with scope 'api':
https://gitlab.git.nrw/-/user_settings/personal_access_tokens?name=divekit&scopes=api

Access token:
******************************************************

┃   VALID   Personal Access Token 
┃                                 
┃  Name     divekit               
┃  Expires  2026-08-14 (29 days)  
┃

Zwei Details in diesem Ablauf sind wichtig:

  • die Expires-Zeile in der VALID-Box: ein Token, der in etwa einem Monat abläuft, ist für diesen Kurs normal
  • nach der Validierung kann eine Keyring-Warnung erscheinen — sie bedeutet, dass Divekit den Credential-Speicher des Betriebssystems nicht nutzen konnte und für diesen Prozess auf einen Fallback ausweicht

Einen ablaufenden Token erneuern

Wenn der Token später kurz vor dem Ablauf steht, ist die Einsteigerlösung einfach:

divekit auth

Wählen Sie danach dieselbe Instanz erneut und geben Sie einen neuen Token ein.

Den konfigurierten Host prüfen

Listen Sie nach dem Setup Ihre konfigurierten Hosts auf:

# Konfigurierte Hosts auflisten
divekit config hosts list

Führen Sie danach doctor erneut aus:

# Umgebung nach dem Authentifizierungs-Setup erneut prüfen
divekit doctor

Beispielhafte Form eines guten Ergebnisses:

$ divekit config hosts list

Configured hosts

  name      gitnrw
  url       https://gitlab.git.nrw
  tokenKey  DIVEKIT_API_TOKEN_GITLAB_GIT_NRW

  Source: /Users/your-name/.divekit/hosts.json

$ divekit doctor
[✓] Divekit Home Directory
[✓] Configuration File
[✓] GitLab Connection & Token
[✓] Environment

Schnelle Einordnung

Was Sie sehen Wie Sie es lesen Was als Nächstes zu tun ist
ein gitnrw-Host-Eintrag erscheint in config hosts list und doctor zeigt gesunde Authentifizierung Normaler Erfolgszustand Weiter zum Projekt-Setup
der Host existiert, aber doctor meldet weiterhin Authentifizierungsprobleme Instanz ist bekannt, der Token ist noch falsch oder abgelaufen divekit auth erneut ausführen und einen frischen Token eingeben
Sie haben die falsche Instanz gewählt Setup passt nicht zusammen divekit auth erneut ausführen und den richtigen Eintrag wählen

Typische Fehler

Was Sie versuchen können

Für diesen Kurs braucht Ihr Token den Scope api.

Wenn doctor weiterhin Authentifizierungsprobleme meldet, erstellen Sie einen neuen Token und erneuern Sie das Setup mit:

divekit auth
Was Sie versuchen können

Diese Warnung ist bei einem kurzlebigen Token normal.

Sie blockiert den Kurs nicht, solange der Token noch gültig ist.

Was Sie versuchen können

Das ist nicht schlimm.

Öffnen Sie die angezeigte URL einfach manuell, erstellen Sie den Token dort und fügen Sie ihn zurück in die CLI ein.

Check

Schließen Sie das Host-Setup ab und prüfen Sie es mit:

divekit config hosts list
divekit doctor
Vorschlag zur Antwort
divekit config hosts list zeigt den Alias gitnrw, der auf https://gitlab.git.nrw zeigt, und divekit doctor meldet keine fehlenden Zugangsdaten mehr. Wenn Sie bewusst eine andere GitLab-Instanz verwenden, sollten Ihr konfigurierter Alias und die Basis-URL stattdessen zu dieser Instanz passen.
Vorschlag zur Antwort
Führen Sie divekit auth erneut aus, wählen Sie dieselbe Instanz und fügen Sie einen neuen Token ein. Sonst muss sich an Ihrem Setup nichts ändern.
Vorschlag zur Antwort
Ihre Distributionskonfiguration referenziert ihn über das Feld remote in config.json. Fehlt der Alias oder ist er falsch, schlägt jedes spätere Kommando fehl, das mit GitLab spricht.