Trac 安装与开发管理

1 安装 Trac 前的准备工作

1.1 准备工作

1. 安装 Python 2.7；
2. 安装 Python Setupfile ；
3. 安装 Genshi ，可以用下面的命令用 Setupfile 来安装。

easy_install Genshi

2 安装 Trac

用 easy_install 来安装 Trac，详细的说明可以看官方文档 ，或者在这一步，直接下载 Windows 的 Trac 安装文件来进行安装。

3 配置Trac环境

完成上述的安装后，就可以创建一个 TracEnvironment，它是 Trac 存储信息的地方，如 wiki pages, tickets, reports, settings 等。

3.1 通过 trac-admin 创建一个 Trac Environment

我的做法是先在d盘新建一个trac目录，然后执行：

$ trac-admin d:/trac/mytest initenv    

然后根据提示输入项目的名字(myproject)，数据库连接字符串（默认），你的源代码资源库路径，根据相应的提示，输入相关信息即可。

如果提示如下错误：

C:\Python27\Scripts>tracd -p 8080 e:/trac/MyTest
Traceback (most recent call last):
  File "C:\Python27\Scripts\tracd-script.py", line 5, in <module>
    from pkg_resources import load_entry_point
  File "C:\Python27\lib\site-packages\pkg_resources.py", line 2603, in <module>
    working_set.require(__requires__)
  File "C:\Python27\lib\site-packages\pkg_resources.py", line 666, in require
    needed = self.resolve(parse_requirements(requirements))
  File "C:\Python27\lib\site-packages\pkg_resources.py", line 565, in resolve
    raise DistributionNotFound(req)  # XXX put more info here
pkg_resources.DistributionNotFound: Genshi>=0.6

则表明没有安装 Genshi。

3.2 运行成功后，即可以开启 Trac 服务

可以通过 tracd 命令 来开启 Trac 服务，命令如下：

tracd --port 8000 E:\Trac\MyTest

启动成功后，即可通过网址：

http://localhost:8000/MyTest

来访问相关的 Trac 服务，这时即访问 MyTest 这个工程。

其它机器也可以通过访问这台机器的 IP 加端口来访问这个服务。最基本、最简单的使用，可以不用 Apache 来搭建 Web 服务器。

3.3 添加用户

刚安装好的 Trac，并没有提供一个用户注册面板，也没有设置管理员权限，这个时候，我们需要自己来添加用户。

这一点经常让我这种习惯了用其它管理系统的人摸不着头脑，系统怎么没有让我设置相关的管理员用户名和密码呢？

最简单的方法是这样的：

直接用 Generating Passwords Without Apache 里提到的方法：

$ python trac-digest.py -u username -p password >> c:\digest.txt
$ tracd --port 8000 --auth=proj_name,c:\digest.txt,trac c:\path\to\proj_name

直接就可以把 username 添加到某个工程里，并可以登陆了。

3.4 Trac 管理员密码的设置

单纯把某个用户添加到了工程里，并不能让这个用户有管理工程的权限，所以，需要单独分配权限给这个用户：

比如说，我要分本给 admn 这个用户管理员权限，可以用下面的语句：

$ trac-admin /path/to/projenv permission add admin TRAC_ADMIN

现在重启一下 Trac 服务器，你再用 admin 登陆，就可以看到右边有一个 Admin 的控制面板了。

最好的办法，你给不同的 projects，添加不同的用户名，为不同的 project，开启不同的端口，这样就不会相互影响了。

3.5 有了管理员密码，就可以进行一些基础配置

• 不让匿名用户看到任何内容

  出于对工作及公司的安全性考虑，我们完全有理由不让匿名用户看到 Trac 里的任何内容。

4 更加高级的功能

4.1 用 Apache 服务器来提供网页版服务

用第4种方法开启的服务，只能在本机使用，如果需要让一个团队都能访问的话，需要开启一个 Apache 服务器。

http://trac.edgewall.org/wiki/TracInstall#RunningTraconaWebServer

4.2 提供网页注册用户名等功能

1. 先安装一个 Trac Account Manager Plugin 工具

可以直接用 easy_install 来安装

1. 重启服务器，在 Plugins 里开启本功能即可。

注意一定要像图中一样，开启那个右上角的 1 字符。

realm 的用处是区分这个用户名属于哪里的，现在这样，很容易地区分出来。和之前 tracd 命令启动时带的参数一样。

还可以针对不同的工程，设定不同的密码文件，这样可以有效地隔离不相干人群。

使用这个还有一个需要注意的，就是，公司内部使用的话，可以把烦人的 Email Verification 关掉。

4.3 提供邮件发送 ticket 提醒等功能

用 Gmail 的话，可查看这篇日志 ，有关如何设置用 Gmail 来发提醒邮件的功能。

4.4 导出为 Excel 或 Word

可以导出数据为 CSV 或 Text 格式：

Trac also exports reports and custom queries to CSV, which will open in Excel directly. Click the "Comma-delimited Text" link near the bottom.

4.5 Trac 的备份

对于 Trac 这种团队用的东西，备份是非常重要的。成一数据丢了，项目也就完蛋了。

Trac 支持热备份 ，可以很方便地用下面的命令来对某个工程进行备份：

$ trac-admin /path/to/projenv hotcopy /path/to/backupdir

注意，这个只能是对工程一个一个的进行备份，其实就是把 Trac 工程的所有文件都打了一个包。

所以，为了备份简单，应该要把密码文件也放到 projenv 的目录里，这样备份起来，会一起把用户名和密码文件打包的。

只要备份完全，你完全可以在别外一台机器上，在另一台机器上配置好 Python 环境，再安装好 Trac ，再把这些备份的文件，扔到一个运行目录里，再用同样的命令就可以直接把该 project 跑起来了。

非常便利！

4.6 Trac 换主题

默认的 Trac 主题并不算十分好看，这里有大把主题可以换：

http://trac-hacks.org/wiki/theme

4.7 Trac 上搭建一个博客系统

可以通过这个博客系统及时通知团队有什么新的更新内容之类的。

安装插件：Self-contained Blog plugin

4.8 Trac 作为服务程序开机启动

5 Trac 的缺陷

针对 Trac 0.12 来说的缺陷，

• 没有办法来定制 component 和 sub-component 这样的层级关系；
• 各种功能都齐全，可是各种功能都不强大，样样都不精；
• 没有办法控制用户可以看到哪个 component 这样的权限，从而不方便对大型项目进行管理；
• 好像没有语言包这种机制，不太好弄。
• 没有办法用邮箱作为用户名。
• 流程定制能力太差，好像没办法定制 driver 和 rider 之类的东西。
• ower 这种东西，没有办法用下拉列表的方式来表示。

[fn:author] 台湾著名计算机技术作家。

Footnotes:

¹ FOOTNOTE DEFINITION NOT FOUND: 1