Logo

`git-vars` konfigurieren

Das Paket git-vars

git-vars konfigurieren

Für die Konfiguration des Pakets git-vars müssen Sie die erforderlichen Konfigurationsangaben hinterlegen. Standardmäßig wird diese Konfiguration in der Datei .git-vars gespeichert. Üblicherweise liegt diese Datei in Ihrem Home-Verzeichnis, also unter /home/<USER>/.git-vars.

Schritte zur Konfiguration von git-vars

1. Konfigurationsbefehl ausführen

git-vars configure --profile <PROFILE_NAME>

2. Erforderliche Angaben machen

Wenn Sie den obigen Befehl ausführen, werden Sie zur Eingabe folgender Angaben aufgefordert:

  • GitLab-Zugriffstoken: Ihr persönliches Zugriffstoken für die Authentifizierung bei GitLab.
  • GitLab-Repository-URL: Die URL des GitLab-Repositorys, das Sie verwalten möchten.
  • GitLab-Gültigkeitsbereich: Geben Sie den Gültigkeitsbereich Ihres GitLab-Zugriffs an. Mögliche Optionen sind in der Regel:
    • project: Für repositoryspezifische Konfigurationen.
    • group: Für Konfigurationen, die für alle Repositorys einer Gruppe gelten.
    • instance: Für Konfigurationen, die für die gesamte GitLab-Instanz gelten.

3. Profile verwalten

Mit der Option --profile können Sie mehrere Konfigurationen in einer einzigen .git-vars-Datei definieren und speichern. Jedes Profil kann eigene Konfigurationen enthalten. Dies ist hilfreich, wenn Sie mit mehreren Repositorys oder GitLab-Instanzen arbeiten.

4. Speicherort der Konfigurationsdatei

Standardmäßig liegt die Datei .git-vars in Ihrem Home-Verzeichnis. Wenn Sie einen anderen Speicherort verwenden möchten, müssen Sie diesen gegebenenfalls in der Konfiguration von git-vars oder in den Umgebungseinstellungen angeben.

Zusätzliche Hinweise

  • Zugriffstoken: Stellen Sie sicher, dass Ihr GitLab-Zugriffstoken die erforderlichen Berechtigungen für die gewünschten Aktionen besitzt (zum Beispiel Lese- und Schreibzugriff auf Umgebungsvariablen).
  • Repository-URL: Verwenden Sie die GitLab-URL von git.nrw im Format https://gitlab.git.nrw/namespace/project.
  • Gültigkeitsbereich: Die Wahl des Gültigkeitsbereichs bestimmt, auf welcher Ebene git-vars zugreifen und Änderungen vornehmen kann. Stellen Sie sicher, dass Sie den passenden Gültigkeitsbereich für Ihren Bedarf wählen.

Die Konfigurationsdatei enthält Ihr Zugriffstoken im Klartext. Führen Sie nach der Konfiguration chmod 600 ~/.git-vars aus und stellen Sie sicher, dass die Datei niemals in ein Repository aufgenommen wird.