チャプター ▾ 第2版

4.7 サーバー上のGit - GitWeb

GitWeb

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

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

GitWebがプロジェクトでどのように表示されるかを確認したい場合、Gitには、システムにlighttpdやwebrickのような軽量なウェブサーバーがインストールされていれば、一時的なインスタンスを起動するコマンドが付属しています。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ディストリビューションには、aptまたはdnfを介してインストールできるgitwebパッケージがあるので、まずそれを試してもよいでしょう。ここでは、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に対応した任意のウェブサーバーで提供できます。別のものを使用したい場合でも、設定は難しくないはずです。この時点で、http://gitserver/にアクセスして、オンラインでリポジトリを表示できるはずです。

scroll-to-top