Kapitel ▾ 2. Auflage

4.7 Git auf dem Server - GitWeb

GitWeb

Nachdem Sie nun grundlegenden Lese-/Schreibzugriff und schreibgeschützten Zugriff auf Ihr Projekt haben, möchten Sie möglicherweise eine einfache webbasierte Visualisierung einrichten. Git wird mit einem CGI-Skript namens GitWeb geliefert, das manchmal dafür verwendet wird.

The GitWeb web-based user interface
Abbildung 49. Die webbasierte Benutzeroberfläche von GitWeb

Wenn Sie überprüfen möchten, wie GitWeb für Ihr Projekt aussehen würde, verfügt Git über einen Befehl, um eine temporäre Instanz zu starten, wenn Sie einen leichtgewichtigen Webserver auf Ihrem System haben, wie z. B. lighttpd oder webrick. Auf Linux-Maschinen ist lighttpd oft installiert, sodass Sie es möglicherweise zum Laufen bringen können, indem Sie git instaweb in Ihrem Projektverzeichnis eingeben. Wenn Sie macOS ausführen, ist Leopard mit Ruby vorinstalliert, daher ist webrick möglicherweise Ihre beste Wahl. Um instaweb mit einem Nicht-Lighttpd-Handler zu starten, können Sie es mit der Option --httpd ausführen.

$ git instaweb --httpd=webrick
[2009-02-21 10:02:21] INFO  WEBrick 1.3.1
[2009-02-21 10:02:21] INFO  ruby 1.8.6 (2008-03-03) [universal-darwin9.0]

Dies startet einen HTTPD-Server auf Port 1234 und startet dann automatisch einen Webbrowser, der sich auf dieser Seite öffnet. Es ist für Sie ziemlich einfach. Wenn Sie fertig sind und den Server herunterfahren möchten, können Sie denselben Befehl mit der Option --stop ausführen

$ git instaweb --httpd=webrick --stop

Wenn Sie die Weboberfläche dauerhaft auf einem Server für Ihr Team oder für ein Open-Source-Projekt, das Sie hosten, ausführen möchten, müssen Sie das CGI-Skript so einrichten, dass es von Ihrem normalen Webserver bereitgestellt wird. Einige Linux-Distributionen haben ein gitweb-Paket, das Sie möglicherweise über apt oder dnf installieren können, daher sollten Sie dies zuerst versuchen. Wir werden sehr schnell durch die manuelle Installation von GitWeb gehen. Zuerst müssen Sie den Git-Quellcode abrufen, mit dem GitWeb geliefert wird, und das benutzerdefinierte CGI-Skript generieren

$ git clone https://git.kernel.org/pub/scm/git/git.git
$ cd git/
$ make GITWEB_PROJECTROOT="/srv/git" prefix=/usr gitweb
    SUBDIR gitweb
    SUBDIR ../
make[2]: `GIT-VERSION-FILE' is up to date.
    GEN gitweb.cgi
    GEN static/gitweb.js
$ sudo cp -Rf gitweb /var/www/

Beachten Sie, dass Sie dem Befehl mit der Variable GITWEB_PROJECTROOT mitteilen müssen, wo Ihre Git-Repositorys zu finden sind. Nun müssen Sie Apache dazu bringen, CGI für dieses Skript zu verwenden, wofür Sie einen VirtualHost hinzufügen können

<VirtualHost *:80>
    ServerName gitserver
    DocumentRoot /var/www/gitweb
    <Directory /var/www/gitweb>
        Options +ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch
        AllowOverride All
        order allow,deny
        Allow from all
        AddHandler cgi-script cgi
        DirectoryIndex gitweb.cgi
    </Directory>
</VirtualHost>

Auch GitWeb kann mit jedem CGI- oder Perl-fähigen Webserver bereitgestellt werden; wenn Sie lieber etwas anderes verwenden möchten, sollte die Einrichtung nicht schwierig sein. An diesem Punkt sollten Sie in der Lage sein, http://gitserver/ zu besuchen, um Ihre Repositorys online anzuzeigen.