Debian Linux 架設 Gitweb

Gitweb 是一個 Web interface, 可以透過 Web 去瀏覽 Git Repository, 實際應用: git.kernel.org

此篇文將假設已經將 Git Server 環境建置完畢, 若尚未建置, 可參考下述:

• Debian Linux 架設使用 HTTP 存取 的 Git Server
• Debian Linux 架設使用 SSH 存取 的 Git Server

相關資料準備

• Gitweb 網址: http://gitweb.example.com
• Git Server Repository 路徑: /var/cache/git # 依照上述兩篇, 預設路徑就是這個.
• 若有要限制只能某些帳號存取, 帳號、密碼檔位置: /etc/apache2/dav_git.passwd

Gitweb 建置步驟

1. apt-get install gitweb
2. vim /etc/gitweb.conf # 修改設定, 若 Repository 位置不在 /var/cache/git, 可由此指定修改.
   

   $projectroot = "/var/cache/git";

3. vim /etc/apache2/sites-available/gitweb.conf
   

   <VirtualHost *:80>
       ServerName gitweb.example.com
       DocumentRoot /usr/share/gitweb/
       SetEnv GITWEB_CONFIG /etc/gitweb.conf

       Options ExecCGI
       AddHandler cgi-script cgi
       DirectoryIndex gitweb.cgi

       RewriteEngine on
       # make the front page an internal rewrite to the gitweb script
       RewriteRule ^/$  /usr/lib/cgi-bin/gitweb.cgi
       # make access for "dumb clients" work
       RewriteRule ^/(.*\.git/(?!/?(HEAD|info|objects|refs)).*)?$ /cgi-bin/gitweb.cgi%{REQUEST_URI}  [L,PT]

       # 若有要限制帳號存取的話, 加入下述這 Location 區塊
       <Location "/">
       DAV on
       AuthType Basic
       AuthName "Git"
       AuthUserFile /etc/apache2/dav_git.passwd
       Require valid-user
       </Location>
   </VirtualHost>

4. ln -s /etc/apache2/sites-available/gitweb.conf /etc/apache2/sites-enabled/gitweb.conf
5. /etc/init.d/apache2 restart
6. 瀏覽 http://gitweb.example.com 即可.

Gitweb 環境設定

Gitweb 頁面上, 會看到 Description 和 Owner 這兩個欄位, 想要改這兩個欄位的值.

Owner

• vim /var/cache/git/project_name.git/config

  [gitweb]
      owner = "Tsung"

Description

• vim /var/cache/git/project_name.git/description

  This is description

相關網頁

• Gitweb README
• Gitweb INSTALL