Debian Linux 架設 Git + Trac

Trac + SVN 的搭配非常方便, 也是一直沒從 SVN 轉換到 Git 的原因之一.

既然想要取代 SVN, Trac + Git 當然也是該要有的, 下面就來將 Trac + Git 完成.

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

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

此篇文章不會詳細解說 Trac 及額外 Trac 指令等, 有興趣可以參考:

安裝步驟

# on Debian / Ubuntu Linux
apt-get install trac libapache2-mod-python
apt-get install trac-git

設定 Trac、存取權限

mkdir -p /var/lib/trac/project_name
trac-admin /var/lib/trac/project_name initenv
Project Name => project_name
Path to repository => /var/cache/git/project_name.git
vim /var/lib/trac/project_name/conf/trac.ini
# 修改
default_charset = iso-8859-15 => default_charset = utf-8
repository_dir = /var/cache/git/project_name.git
repository_type = git

# 於檔案最後面增加
[components]
# for plugin version 0.10 (如果 trac 版本是 0.10, 下面 gitplugin 前的 # 要拿掉)
# gitplugin.* = enabled

# for plugin version 0.11.0.1+ (目前 Debian Testing 版 trac 為 0.11, 需要加這段)
tracext.git.* = enabled
chown www-data:www-data -R /var/lib/trac/project_name
trac-admin /var/lib/trac/project_name permission list # 列出有哪些帳號可以存取
trac-admin /var/lib/trac/project_name permission remove anonymous '*' # 不允許匿名存取
trac-admin /var/lib/trac/project_name permission add test_user TRAC_ADMIN # 增加帳號

設定 Apache VirtualHost

vim /etc/apache2/sites-available/trac_project_name.conf
<VirtualHost *>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/lib/trac/project_name
    ServerName project_name.example.com
    ErrorLog /var/log/apache2/trac-project_name-error.log
    CustomLog /var/log/apache2/trac-project_name-access.log combined

    SetHandler mod_python
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnv "/var/lib/trac/project_name"
    PythonOption TracUriRoot "/trac/project_name"
    <LocationMatch "/trac/[^/]+/login">
        AuthType Basic
        AuthName "Trac"
        AuthUserFile /etc/apache2/dav_git.passwd
        Require valid-user
    </LocationMatch>
</VirtualHost>
ln -s /etc/apache2/sites-available/trac_project_name.conf /etc/apache2/sites-enabled/trac_project_name.conf
/etc/init.d/apache2 restart
瀏覽 http://project_name.example.com/trac/project_name/ 即完成.

問題與解法

若 Git 安裝完, 一直說沒有 Git 相關套件的, 可試著安裝 GitPlugin.

Trac+git 來管理wiki和source code

環境： Centos 5.3

目標： CentOS作為服務器，來管理項目的源代碼和wiki文檔。

步驟：

1. 安裝 Trac:

使用的是trac-0.10版本，沒有用最新的，由於python版本是2.4的，trac-0.11需要2.5以上版本。

從網上下載安裝包： http://trac.edgewall.org/

其他的安裝包，setuptools, genshi, sqlite, clearsilver

2. 安裝apache,

使用yum install httpd

3. 安裝git

從網上搜到git的源碼，然後安裝。

4. 建立 git repository:
     % cd /path/to/your/src
     % git init
     % tar xzvf your.src.tar.gz
     % git add *
     % git commit -a -m "First revision"

     % cd /path/to/your/git-web
     % git clone --bare /path/to/your/src   prj1.git
     % touch prj1.git/git-daemon-export-ok

     % ls -F git-web/prj1.git
       branch/    config    HEAD   hooks/    info/    objects/     refs/      description

確認上述建立成功：

% cd /path/to/new/src
% git clone ssh://your-ip-address/path/to/your/git-web/prj1.git

你可以看到clone下來的源代碼就是你項目的源代碼。

5. 設置trac環境

% cd /path/to/trac; mkdir prj1
% trac-admin /path/to/trac-env/prj1 initenv

Repository : /path/to/your/git-web/prj1.git
Version Control = git

% pwd
/path/to/trac-env

修改 trac.cgi, 加入一行:
try:
import os
++ os.environ['TRAC_ENV_PARENT_DIR'] = '/path/to/trac-env'
import pkg-resources

設定登陸密碼

% htdigest -c shares/trac.htpasswd "your-realm" user_acc
New password:
Re-type new password:
其中:
your-realm : 這個字串要跟 httpd.conf 中的設定一致，以下的動作中會說明.
user-acc : 使用者帳號

% htdigest shares/trac.htpasswd "your-realm" user_acc
==> 加第二個以上的使用者時，不需要 "-c" 參數了

6. 安裝 gitplugin

官方網上有tar包，可以安裝。

% pythod setup.py bdist_egg
==> output 在 dist/TracGit-0.10.0.1-py2.4.egg
% cp dist/TracGit-0.10.0.1-py2.4.egg /path/to/trac-env/prj1/plugins
root $ chown -R apache.apache /path/to/trac-env/prj1/plugins

7. 修改 trac 環境設置 trac.ini
     % cd /path/to/trac-env/prj1/conf
     % vi trac.ini
        [logging]
           log-type = none file          <--- 需要 debug 時

        新增以下內容:
        [git]
                cached_repository = true
                persistent_cache = true
                shortrev_len = 6
                git_bin = /path/to/git  <--- 可用 "which git" 找一下你的 git 程式是安裝到哪

        [components]
                gitplugin.* = enabled

8. 測試是否成功：