Trac项目跟踪系统构建与使用
Trac项目跟踪系统构建与使用
2010-5-27
陈 恒
一、Trac简介
Trac是一个基于Python的项目跟踪和管理软件。通常与Apache和SVN工作在一起。
二、Trac安装
2.1 基本安装
Trac安装看起来很繁琐，不过理清楚了，也还是比较容易的。这里安装Trac时，选择的是0.11版。
Ø 安装要求：
1、2.3 =< Python < 3.0
Python在系统安装时已经选择了，这时是2.4版本。
2、setuptools >= 0.6
Setuptools是一个Python模块，它可以Python包打包成egg文件，以便于编译，发布和安装。它可以通过如下方式安装：
Shell>wget http://peak.telecommunity.com/dist/ez_setup.py
Shell>python ez_setup.py
Shell>rm ez_setup.py
3、Genshi >= 0.5
Genshi是一个Python模板引擎，用于取代Trac使用的 ClearSilver HTML模板引擎，不再依赖 ClearSilver 及其依赖的 C，使得可移植性大为提高，现在已经发展为一个独立的组件。
安装好Setuptools，可以通过如下方式安装：
Shell>easy_install Genshi
Ø 安装数据库：
Trac需要数据库的支持。可以是SQLite，Postgre SQL，MySQL等。这里选择SQLite。到这里下载SQLite：
http://code.google.com/p/pysqlite/downloads/detail?name=pysqlite-2.6.0.tar.gz&can=2&q=
Shell> tar zxvf pysqlite-2.6.0.tar.gz
Shell> cd pysqlite-2.6.0
Shell> python setup.py build_static install
Ø 安装Trac
easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11
2.2 整合Trac到Apache
Apache是一个非常有名的开源WEB服务器。要将Trac整合到Apache中，需要Apache包含mod_python模块。如果没有安装这个模块，可以通过如下命令安装：
Shell> yum install mod_python
这里将Trac以虚拟主机的方式运行在Apache中。http.conf中的配制信息如下：
<VirtualHost *:80>
ServerAdmin heng.chen@vogins.com
DocumentRoot /vogins/share/trac/bssproject
ServerName trac.vogins.com
<Location />
SetHandler mod_python
PythonInterpreter main_interpreter
PythonHandler trac.web.modpython_frontend
#如果Trac多个项目，去掉下行的注释，并将TracEnv行注释掉
#PythonOption TracEnvParentDir /vogins/share/trac/bssproject
#这里先以一个Trac项目为例，所以使用了TracEnv 选项。
#这里的/vogins/share/trac/bssproject是指通过trac-admin建立的项目路径。关
#于如何使用trac-admin将在后面介绍。
PythonOption TracEnv /vogins/share/trac/bssproject
PythonOption TracUriRoot /
PythonDebug on
</Location>
<Location /login>
AuthType Basic
AuthName "Vogins BSS Trac Server"
# 这里是密码文件保存的路径，关于如何设置帐号和密码，将在后面介绍。
AuthUserFile /vogins/share/trac/bssproject/.htpasswd
Require valid-user
</Location>
ErrorLog logs/trac.vogins.com-error_log
CustomLog logs/trac.vogins.com-access_log common
</VirtualHost>
注意：由于启用了SELinux，要确保/vogins/share/trac文件夹及其下面的内容是可以访问的。具体操作请参考SELinux中的介绍。
2.3 安装SVN
关于SVN的安装的配制请查找相关文档。这里不再重述。
三、使用Trac
3.1 创建Trac项目环境
使用trac-admin来创建trac项目环境：
Shell>trac-admin /vogins/share/trac/bssproject initenv
运行指令后，会提示你输入svn仓库路径、数据库联系串等信息。由于默认就是SQLite，所以数据库相关的设置默认即可。Svn仓库就需要输入你的准确路径了。
关于trac-admin指令的具体说明，可以通过trac-admin help 查阅。
3.2 创建Trac帐户/密码
考虑到Trac目前在内部使用，直接使用apache的htpasswd指令创建帐户/密码即可。
创建第一个用户：
Shell> htpasswd –c /vogins/share/trac/bssproject/.htpasswd admin
New password: <type password>
Re-type new password: <type password again>
Adding password for user admin
创建第一个用户以后，如果有新用户要添加，仍然使用上面的命令，但不在使用”-c”选项。
3.3 调整用户权限
用户权限主要是通过trac-admin来分配的。具体权限要求，根据实际情况来确定。Trac本身也带有这方面的文档。在此就不多做分析了。下面这个例子是给管理员授予所有权限：
Shell> trac-admin bssproject/ permission add admin TRAC_ADMIN
3.4 其它使用细节
其它使用方法就靠在工作中不断深入学习了。这里也就不在具体分析了。