基于 Debian 的 Subversion+Trac
2008-11-21 來(lái)源：linuxlife.cn
之前都是用 bugzilla 來(lái)做 bug管理.現(xiàn)在準(zhǔn)備換到 Trac 上.Trac 擁有強(qiáng)大的 bug 管理功能,并集成 wiki 和 Subversion.還有一點(diǎn),據(jù)說(shuō) Facebook 也是在用 Trac 來(lái)做bug管理 ^0^.
Bug 管理
在Trac中，項(xiàng)目中出現(xiàn)的問(wèn)題稱為ticket。像bug、功能改進(jìn)、 TODO等都可以寫成一個(gè)ticket。
1.)可設(shè)置ticket的優(yōu)先級(jí)別。
2.)可以設(shè)置ticket的里程碑，表明這個(gè)ticket應(yīng)在何時(shí)完成，并能夠通過(guò)條形圖方式顯示里程碑的完成度。
3.)可以自定義條件生成bug報(bào)告，并可以通過(guò)SQL語(yǔ)句自定義報(bào)告的格式。
Subversion 集成
通過(guò)Subversion集成，開發(fā)者可在Trac中以Web方式瀏覽代碼庫(kù)中各個(gè)版本的代碼和代碼的修改歷史，并可方便地比較各個(gè)版本間的差別。
Wiki
支持常用的Wiki語(yǔ)法。同時(shí)增加了許多bug管理的專用標(biāo)記，可以方便地創(chuàng)建到ticket、代碼行甚至修改歷史的鏈接。
Trac使用Python寫成，后臺(tái)使用SQLite或PostgreSQL數(shù)據(jù)庫(kù)，因此構(gòu)筑一個(gè)完整的Trac系統(tǒng)需要安裝以下軟件：
Apache
Python
Subversion
PostgreSQL(可選)
Debian 下的安裝很方便,我的系統(tǒng)是 Debian eth4
aptitude install trac apache2 subversion python swig aptitude install mod_python python-clearsilver libapache2-svn
這樣一個(gè)基本的環(huán)境就安裝好了,你也可以用源碼包來(lái)安裝,你必須滿足以下條件:
Python, version >= 2.3.
ClearSilver, version >= 0.9.3
For SQLite
SQLite, version 2.8.x or 3.x (preferred)
PySQLite, version 1.x (for SQLite 2.x) or version 2.x (for SQLite 3.x). For details see
PySqliteFor PostgreSQL
PostgreSQL psycopg2 or
pyPgSQLFor MySQL
Warning: MySQL support is currently experimental. That means it works for some people, but has not been tested extensively yet.
MySQL, version 4.1 or later
MySQLdb, version 1.2.1 or later
Note: MySQL support requires Trac version 0.10 or later.
Subversion, version >= 1.0. (either 1.2.3 or >= 1.3.1 recommended)
Web Server
A CGI-capable web server (see
TracCgi), or
a
FastCGI-capable web server (see
TracFastCgi), or
Apache with
mod_python 3.1.3+ (see
TracModPython) When installing mod_python the development versions of Python and Apache are required (actually the libraries and header files)
—————————————————————–
接下來(lái)就是配置了.
1,配置svn
首先創(chuàng)建一用戶對(duì)svn權(quán)限的管理,這里我們就用 linuxlife
#groupadd linuxlife
#useradd svn -g linuxlife -s /usr/sbin/nologin
#passwd linuxlife
然后創(chuàng)建 svn 倉(cāng)庫(kù),默認(rèn)為 fsfs 文件格式
# mkdir -p /home/linuxlife/svn/
#svnadmin create /home/linuxlife/svn/my_project
chown -R linuxlife:linuxlife /home/linuxlife/svn
chmod -R g+w /home/linuxlife/svn/my_project
chmod g+s home/linuxlife/svn/my_project/db
配置 apache,apache如何配可根據(jù)系統(tǒng)的整理規(guī)劃,只需copy添加代碼就可
# vi /etc/apache2/sites-available/default
添加以下部分
### svn settings
#
<Location /svn>
DAV svn
SVNListParentPath on
SVNParentPath /home/linuxlife/svn
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/svntrac.htpasswd
<LimitExcept GET PROPFIND OPTIONS REPORT>
Require valid-user
</LimitExcept>
</Location>
SVNListParentPath on —-允許在網(wǎng)頁(yè)上顯示svn父目錄list
SVNParentPath /home/svn —-/home/svn是我這邊的SVN的父目錄
AuthType Basic —-連接類型設(shè)置
加了LimitExcept這樣匿名用戶可以瀏覽,check out代碼，但是不能commit, 認(rèn)證用戶有commit權(quán)限
如果有多個(gè)倉(cāng)庫(kù),可以用 svnparenpath ,如果就一個(gè)用 svnpath 即可.
# htpasswd -c /etc/svntrac.htpasswd
添加認(rèn)證
接下來(lái)就是需要修改 apache 的 User 和 Group 了,在 debian 中
# vi /etc/apache2/apache2.conf
User linuxlife
Group linuxlife
改成這樣既可
# apache2 -k restart
重啟 apache 后,打開瀏覽器訪問(wèn)
http://localhost/svn 即可訪問(wèn)svn.
現(xiàn)在開始導(dǎo)入代碼或者你需要版本控制的文件.
# mkdir /tmp/svn
# cd /tmp/svn
# mkdir {trunk,tags,branches}
svn import -m "linuxlife's project" [path] http://svn_server_address/svn/my_project
[path] 是導(dǎo)入的路徑，不寫就是當(dāng)前路徑
path目錄下,需要建立三個(gè)目錄: trunk, tags, branches (類似CVS)這不是必須的，但是這對(duì)今后的項(xiàng)目管理很有好處
把最初的代碼放在trunk目錄下!
import之后用command “svn co http://svn_server_address/svn/my_project”就該可以check out剛才import的代碼了
應(yīng)該說(shuō)svn和apache就處理好了!接下來(lái)就是安裝配置Trac….
2.配置 trac
使用 trac-admin 命令可以初始化一個(gè)trac項(xiàng)目，一個(gè) trac 項(xiàng)目對(duì)應(yīng)一個(gè) SVN repository，這是應(yīng)用中應(yīng)該注意的.
# mkdir /home/linuxlife/trac
#trac-admin /home/linuxlife/trac/my_project initenv
然后按提示輸入,記得注意是 倉(cāng)庫(kù)類型選 svn,倉(cāng)庫(kù)路徑按照本例就是 /home/linuxlife/svn/my_project
trac 有2中方式提供web服務(wù),一種是 trac 自帶的 httpd 服務(wù),一種是集成到 apache 里面,如果要用自帶的 httpd ,只需這樣
tracd --port 8000 /home/linuxlife/trac/my_project
這種方式很簡(jiǎn)單,但 trac 本身就不建議這樣啟動(dòng).我們要做的,是集成到 apache 里面去.
首先確定你的 apche 配置 cgi-bin 的路徑.我的 配置例子是把這個(gè)目錄正道 /var/www/cgi-bin/ 這里面去了.
所以需要 copy 兩個(gè)文件到這個(gè)目錄下.
# cp /usr/share/trac/cgi-bin/trac.* /var/www/cgi-bin/
接著修改 apache 配置
# vi /etc/apache2/sites-available/default
添加以下內(nèi)容
Alias /trac/chrome/common "/usr/share/trac/htdocs"
<Directory "/usr/share/trac/htdocs">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>
ScriptAlias /trac /var/www/cgi-bin/trac.cgi
<Location "/trac">
SetEnv TRAC_ENV_PARENT_DIR "/home/linuxlife/trac"
</Location>
<Location "/trac/*/login">
AuthType Basic
AuthName "Trac Login"
AuthUserFile /etc/svntrac.htpasswd
Require valid-user
</Location>
密碼文件 svntrac.htpasswd 我們和 svn 共享,這樣就只需要管理一套密碼了.
保存,退出,重啟 apache.再訪問(wèn)
http://localhost/trac看看是不是可以得到trac的默認(rèn)首頁(yè),然后點(diǎn)擊 “browse source”, 你應(yīng)該可以看到 svn 倉(cāng)庫(kù)里的資源.
管理Trac訪問(wèn)許可
Trac的許可權(quán)限管理簡(jiǎn)單而有效,它可通過(guò) trac-admin 命令來(lái)管理.用 trac-admin 可管理用戶的許可權(quán)限,但用戶的管理是通過(guò) Apache 的 htpasswd 命令設(shè)置的，根據(jù)上面的 Apache CGI 配置,用戶名和密碼是存放在 /etc/svntrac.htpasswd 文件中.下面這個(gè)命令可用來(lái)列出當(dāng)前有效的許可權(quán)限和已設(shè)置的許可權(quán)限.
# trac-admin /home/linuxlife/trac/svn_trac_daily permission list
User Action
——————————
anonymous BROWSER_VIEW
anonymous CHANGESET_VIEW
anonymous FILE_VIEW
anonymous LOG_VIEW
anonymous MILESTONE_VIEW
anonymous REPORT_SQL_VIEW
anonymous REPORT_VIEW
anonymous ROADMAP_VIEW
anonymous SEARCH_VIEW
anonymous TICKET_VIEW
anonymous TIMELINE_VIEW
anonymous WIKI_VIEW
authenticated TICKET_CREATE
authenticated TICKET_MODIFY
authenticated WIKI_CREATE
authenticated WIKI_MODIFY
上面列出的內(nèi)容是還沒(méi)進(jìn)行許可權(quán)限設(shè)置時(shí)的情況，Available actions段的內(nèi)容就是有效許可權(quán)限的列表，每個(gè)權(quán)限的解析可查詢TracGuide中的TracPermission節(jié)的內(nèi)容。其中 TRAC_ADMIN許可相當(dāng)于Linux中的root用戶，擁有最高的權(quán)限。如果我們要把TRAC_ADMIN許可授予 linuxlife 用戶，則可這樣設(shè)置：
# trac-admin /home/trac/my_project permission add linuxlife TRAC_ADMIN
WIKI_ADMIN是WIKI系統(tǒng)的管理員，具有WIKI_CREATE，WIKI_DELETE， WIKI_MODIFY， WIKI_VIEW權(quán)限。也就是WIKI頁(yè)面的創(chuàng)建、刪除、修改和查看四種權(quán)限，授予方式同上。
刪除用戶的許可可用remove關(guān)健字，如：
# trac-admin /home/linuxlife/trac/my_project permission remove linuxlife TRAC_ADMIN
在Trac的權(quán)限管理中可以設(shè)置組以簡(jiǎn)化權(quán)限配置，下例將設(shè)置一個(gè)admin組，具有TRAC_ADMIN許可權(quán)限，把jims和ringkee兩個(gè)用戶加入到該組中，使他們也具有TRAC_ADMIN許可權(quán)限：
# trac-admin /home/linuxlife/trac/my_project permission add admin TRAC_ADMIN
# trac-admin /home/linuxlife/trac/my_project permission add jason admin
# trac-admin /home/linuxlife/trac/my_project permission add jims admin
在Trac的用戶中，有兩個(gè)默認(rèn)的用戶，一個(gè)是anonymous，表示匿名用戶；一個(gè)是authenticated，表示所有已通過(guò)驗(yàn)證的用戶。我們可以把許可權(quán)賦予這兩個(gè)用戶，從而簡(jiǎn)化我們的許可權(quán)限配置。
備份和恢復(fù)Trac
Trac系統(tǒng)的備份和恢復(fù)也可使用trac-admin工具來(lái)完成，還可支持熱備份。備份命令如下：
# trac-admin /home/linuxlife/trac/my_project hotcopy ~/backup
執(zhí)行該命令時(shí)，Trac會(huì)自動(dòng)鎖住SQLite數(shù)據(jù)庫(kù)，并把/home/trac/my_project目錄拷貝到~/backup目錄。恢復(fù)備份也很簡(jiǎn) 單，只需停止Trac進(jìn)程，如Apache服務(wù)器或tracd服務(wù)器。接著把~/backup整個(gè)目錄恢復(fù)回/data/trac目錄就可以了。
到此trac也配完了。
