Git
目次 ▾ 第2版

4.7 サーバー上のGit - GitWeb

GitWeb

プロジェクトへの基本的な読み書きアクセスと読み取り専用アクセスが設定できたので、簡単なウェブベースのビジュアライザを設定したいかもしれません。Gitには、このために時々使用されるGitWebというCGIスクリプトが付属しています。

The GitWeb web-based user interface
図49. GitWebウェブベースユーザーインターフェース

GitWebがプロジェクトでどのように見えるかを確認したい場合は、`lighttpd`や`webrick`のような軽量なウェブサーバーがシステムにインストールされていれば、一時的なインスタンスを起動するためのコマンドがGitに付属しています。Linuxマシンでは、`lighttpd`がインストールされていることが多いので、プロジェクトディレクトリで`git instaweb`と入力して実行できる可能性があります。macOSを使用している場合、LeopardにはRubyがプリインストールされているため、`webrick`が最適な選択肢かもしれません。`lighttpd`以外のハンドラーで`instaweb`を起動するには、`--httpd`オプションを使用して実行します。

$ 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]

これにより、1234番ポートでHTTPDサーバーが起動し、そのページが開くウェブブラウザが自動的に起動します。非常に簡単です。終了してサーバーをシャットダウンしたい場合は、`--stop`オプションを使用して同じコマンドを実行します。

$ git instaweb --httpd=webrick --stop

チーム向け、またはホスティングしているオープンソースプロジェクト向けに、サーバーで常にウェブインターフェースを実行する場合は、通常のウェブサーバーでCGIスクリプトが提供されるように設定する必要があります。一部のLinuxディストリビューションには`gitweb`パッケージがあり、`apt`または`dnf`を介してインストールできる可能性があるため、最初に試してみることをお勧めします。GitWebの手動インストール手順を簡単に説明します。まず、GitWebが付属しているGitのソースコードを取得し、カスタムCGIスクリプトを生成する必要があります。

$ 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/

`GITWEB_PROJECTROOT`変数を使用して、Gitリポジトリの場所をコマンドに伝える必要があることに注意してください。次に、ApacheでそのスクリプトにCGIを使用するように設定する必要があります。そのためには、VirtualHostを追加します。

<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>

繰り返しますが、GitWeb は、CGI または Perl に対応した任意の Web サーバーで動作します。他のものを使用することを希望する場合でも、設定は容易です。この段階で、`http://gitserver/` にアクセスして、オンラインでリポジトリを参照できるはずです。

scroll-to-top