Gitolite

Gitolite auf der DS

Gitolite erleichtert die Rechtevergabe bzw. die Zugangskontrolle zum Versionsverwaltungssystem git auf der DS.

Installation

Voraussetzungen

• Zugang auf die Kommandozeile (Shell)
• Umgang mit einem Editor z.B. vi
• Paketverwaltung ipkg muss installiert sein
• Login auf die Shell als root mit SSH Keys
• SCP muss installiert sein

Git installieren

Erstmal müsst ihr das Paket git auf eurer DS installieren.

$ ipkg update
$ ipkg install git

Zusätzlich sollte mktemp installiert werden, da das gitolite setup dieses benötigt

$ ipkg install mktemp

Neuen Benutzer anlegen + Zugang zur Kommandozeile aktivieren

1. Legt im DSM einen neuen Benutzer, der als Zugang zum git-Server dienen soll, an und aktiviert den home-Ordner.
2. Für diesen Benutzer müsst ihr nun den Zugang zur Kommandozeile aktivieren.
   1. Loggt euch dazu als root auf eurer DS ein und führt dieses Kommando aus:

       $ vi /etc/passwd 

   2. Jetzt ändert ihr die Zeile

       EUER_BENUTZER:x:1028:100::/var/services/homes/EUER_BENUTZER:/sbin/nologin 

      auf

       EUER_BENUTZER:x:1028:100::/var/services/homes/EUER_BENUTZER:/bin/ash 

      und speichert die Datei ab.

Sonstige hilfreiche Kommandos

1. Um Problemen bei der späteren Verwendung des git-Servers vorzubeugen, erstellen wir auf der DS einen Symbolic Link auf die git-Tools und mktemp

$ ln -s /opt/bin/git* /usr/bin/
$ ln -s /opt/bin/coreutils-mktemp /usr/bin/mktemp

Gitolite herunterladen + installieren

1. Klont euch nun das gitolite-Repository auf euren Rechner

    $ git clone http://github.com/sitaramc/gitolite.git 

2. Wechselt nun in diesen Ordner

    $ cd gitolite 

3. Um Gitolite auf der DS zu installieren müsst ihr dieses Kommando (auf eurem Rechner) aufrufen

    $ exec ./src/gl-easy-install EUER_BENUTZER IP_zur_DS ADMIN_in_den_Repositorys 

   (gibt es bei aktuellen Gitolite Versionen nicht mehr!)
4. Folgt nun den Ausgaben auf der Kommandozeile bis zu dem Punkt wo ihr die Datei "gitolite.rc" bearbeiten könnt. Ändert dann den Eintrag

    $GIT_PATH=""; 

    # $GIT_PATH="/opt/bin/"; 

   auf

    # $GIT_PATH=""; 

    $GIT_PATH="/opt/bin/"; 

   und speichert die Datei ab
5. Nun folgt den Ausgaben auf der Kommandozeile bis zum Schluss

Verwendung von Gitolite

Die Verwendung von Gitolite auf der DS unterscheidet sich nicht von anderen Systemen, daher könnt ihr in der Gitolite-Dokumentation nachlesen wie ihr Gitolite benutzen könnt.