Logo

Divekit installieren und das System prüfen

Orientierung und Setup

Divekit installieren und das System prüfen

In dieser Lektion installieren Sie Divekit CLI und prüfen, ob die lokale Umgebung fit für den Kurs ist.

Für die Installation brauchen Sie:

  • ein unterstütztes Betriebssystem: Linux, macOS oder Windows
  • Zugang zu einer GitLab-Instanz
  • die Berechtigung, auf der Ziel-GitLab-Instanz Gruppen und Repositories anzulegen

Das Token-Setup müssen Sie noch nicht abschließen.
Die CLI fragt danach in der Authentifizierungslektion.

Installation

Verwenden Sie in diesem Kurs den geführten Installer als Standardweg.

Auf Unix-artigen Systemen führen Sie aus:

curl -fsSL 'https://gitlab.git.nrw/api/v4/projects/divekit%2Fdivekit-cli/repository/files/scripts%2Finstall.sh/raw?ref=main' | bash

Das ist der Haupt-Installationsweg für den Einsteigerkurs.

Alternative Installationswege anzeigen

Wenn Sie bereits eine lokale Binary aus einem Build oder Release-Artefakt haben:

./divekit install

Unter Windows lautet der entsprechende lokale Installationsschritt:

./divekit.exe install

Installationsort

Divekit verwendet eine verwaltete Installation auf Benutzerebene.

  • Unix: bevorzugt ~/.local/bin, andernfalls ~/.divekit/bin
  • Windows: installiert in das Divekit-Verzeichnis auf Benutzerebene

Eine systemweite Installation brauchen Sie für diesen Kurs nicht.

So sieht ein gesundes Ergebnis aus

Prüfen Sie nach der Installation das Setup:

# Installation und Umgebung prüfen
divekit doctor

Für diesen Kurs ist ein guter Erfolgszustand:

  • divekit doctor läuft durch und endet erfolgreich
  • die Binary ist aus Ihrer Shell aufrufbar
  • jede verbleibende Warnung betrifft das Host- oder Token-Setup, nicht die Installation selbst

Eine Token-Warnung kann an dieser Stelle noch erscheinen. Das ist bis zur nächsten Lektion in Ordnung.

Beispielhafte Form eines gesunden Ergebnisses in dieser Phase:

[✓] Divekit Home Directory - Divekit home directory is properly initialized
[✓] Configuration File - Configuration system is accessible
[✗] GitLab Connection & Token - GitLab project target checks failed
    • Host https://gitlab.git.nrw reachable
    ! Warning: Host gitnrw is missing credentials
    • Run 'divekit auth' to refresh credentials
[✓] Environment - Environment info

Wenn Sie nur die Authentifizierungs-Warnung sehen, machen Sie mit der nächsten Lektion weiter.
Wenn Sie Installations- oder PATH-Fehler sehen, beheben Sie diese, bevor Sie weitermachen.

Schnelle Einordnung

Was Sie sehen Wie Sie es lesen Was als Nächstes zu tun ist
doctor läuft und nur die GitLab-Authentifizierung ist noch offen Normal in dieser Phase Weiter zum Host-Setup
doctor läuft und die zentralen Umgebungs-Checks sind gesund Guter Installationszustand Weitermachen
divekit: command not found oder ähnliche PATH-Fehler Keine normale Warnung Installation reparieren, bevor Sie weitermachen
fehlende Binary oder kaputter Installationsort Installation fehlgeschlagen oder Shell nicht neu geladen Terminal neu öffnen oder neu installieren

Typische Fehler

Was Sie versuchen können

Mögliche Gründe:

  • die Shell hat ihren PATH noch nicht neu geladen
  • die Terminal-Sitzung verwendet noch die alte Umgebung
  • der Installer ist nicht sauber durchgelaufen

Wenn Sie ein neues Terminal öffnen können, tun Sie das zuerst und führen Sie aus:

divekit doctor

Wenn Sie in der aktuellen Shell-Sitzung bleiben, laden Sie die zu Ihrer Shell passende Konfiguration neu:

# Wenn der Installer "Updated PATH in /pfad/zur/datei" meldet,
# sourcen Sie genau diese Datei.
source ~/.profile

# Häufige Alternativen
source ~/.zshrc
source ~/.bashrc

Wenn die Binary installiert wurde, die aktuelle Shell sie aber weiterhin nicht sieht, ergänzen Sie den verwalteten Installationspfad manuell für die aktuelle Sitzung:

export PATH="$HOME/.local/bin:$PATH"
export PATH="$HOME/.divekit/bin:$PATH"
hash -r

Versuchen Sie es dann erneut:

divekit doctor

In Containern oder temporären Bash-Sitzungen ist oft ~/.profile die entscheidende Datei, nicht ~/.bashrc.
hash -r hilft erst, wenn Ihre aktuelle Shell den korrekten PATH hat.

Wenn das immer noch fehlschlägt, prüfen Sie Ihre Shell-Startdateien und wiederholen Sie die Installation.

Was Sie versuchen können

Manche Einrichtungen schränken die direkte Skriptausführung ein oder blockieren den curl | bash-Weg.

Erfinden Sie in dem Fall keinen neuen manuellen Workflow mitten in der Lektion.

Verwenden Sie stattdessen einen der alternativen Installationswege oben:

  1. das passende Release-Archiv herunterladen
  2. die Binary entpacken
  3. den lokalen Installationsschritt mit ./divekit install oder ./divekit.exe install ausführen
Was Sie versuchen können
Das ist zu erwarten, wenn Sie noch keinen GitLab-Host konfiguriert haben. Machen Sie mit der nächsten Lektion weiter.

Check

Installieren Sie Divekit und führen Sie dann aus:

divekit doctor
Vorschlag zur Antwort
Die zentralen Checks bestehen und divekit ist aus Ihrer Shell aufrufbar. Eine Warnung über fehlende GitLab-Zugangsdaten ist hier zu erwarten — die nächste Lektion konfiguriert Host und Token.
Vorschlag zur Antwort
Alles, was die CLI selbst kaputt macht: divekit: command not found, PATH-Probleme oder eine fehlgeschlagene Installation. Nur Authentifizierungs-Warnungen dürfen bis zur nächsten Lektion warten.