Windows下Trac的安装与基本配置
Trac是一个基于Web的,轻量级的项目管理工具,它使用python语言编写。在本文中,将介绍windows下安装、集成配置一个简单的Trac环境,并通过浏览器访问和使用Trac站点。Trac环境中,默认的版本控制工具是Subversion,在这里我假定大家已经安装和部署了SVN仓库。
安装前要说的
1. 关于本文中Trac的版本
Trac目前最新的Release版本是0.10.4版本,0.11版本正在开发。本文针对的是0.10.4版本,0.11版本做了大量的更新,使用了新的模板,并集成了配置工具,预计近期发布,但目前的成熟度还不高,建议大家使用0.10.4版本。
2. 必须的组件
Python,版本 >= 2.3。目前最新版本是2.5,因为Trac 0.10.x是在2.4版本下开发的,并且2.5版本是新发布的,在Trac的官方文档中也说在Python2.5环境下使用0.10.x理论上可以工作,为了避免不必要的麻烦,建议大家使用2.4版本,本文就以2.4版来介绍。
ClearSilver,版本 >= 0.9.3,目前最新版是0.10.4(注意,0.10.4版本需要Python2.5)。这是一套快速、强大、语言无关的html模板系统,在Trac0.11版本中被Genshi取代。
数据库,Trac需要一个数据库来集中存放数据,目前支持的数据库包括SQLite,PostgreSQL和MySQL。默认使用SQLite,我个人非常喜欢SQLite这个小东西,功能够用,部署方便,配置简单(简单到不需要配置),对于小团队完全够用。本文就使用SQLite,如果使用其他的数据库,请参照Trac官方文档。SQLite需要3.3.4版本或以上。
使用SQLite,必须安装 PySQLite, 需要版本2.x。
3. 可选的组件
版本控制系统,Trac功能上的一个亮点就是和版本控制工具的集成,默认使用Subversion,本文使用Subversion。但是从本质上讲,版本控制系统,并不是Trac所必须的,只是集成了版本控制系统,使Trac更强大,这也是为什么Subversion是可选组件的原因。使用Subversion还需要相应的Python绑定(the corresponding Python bindings)。
Web服务器,在支持CGI或FastCGI的Web服务器上,Trac可以通过脚本和接口作为一个CGI来运行。还可以使用Apache服务器,但需要安装mod_python或mod_wsgi。以上的Web服务器部署方式,可能对大部分人都太复杂,所以Trac内置了一个单独运行的Web服务器,Tracd。在Trac官方的文档中说,Tracd是一个轻量级的、独立的Trac web服务器,在大多数情况下,它比CGI脚本更容易安装,并且更快。在本文中,我将使用Tracd作为Web服务器。(我不懂CGI和Apache,Tracd拯救了我,这个小东东对我完全够用了)
开始安装
1. 下载程序
根据上面所说,我下载的程序包括
Python 2.4:http://www.python.org/ftp/python/2.4.4/python-2.4.4.msi
Trac 0.10.4:http://ftp.edgewall.com/pub/trac/trac-0.10.4.win32.exe
ClearSilver 0.9.14(我只找到了这个版本的安装包,其他版本都是源码,我不会安装,抱歉):http://www.clearsilver.net/downloads/win32/clearsilver-0.9.14.win32-py2.4.exe
SQLite:不用下载,就一个文件而已,Trac里面已经包含了。
pysqlite 2.3.4(注意,使用for Python2.4的版本):http://initd.org/pub/software/pysqlite/releases/2.3/2.3.4/pysqlite-2.3.4.win32-py2.4.exe
Subversion:需要注意,Trac需要python绑定。如果你已经安装了Subversion,没有python绑定,可以下载单独的python绑定,并安装,具体在http://subversion.tigris.org/files/documents/15/38210/svn-win32-1.4.4_py24.zip。也可以卸载subversion,安装subversion的python绑定安装包,在http://subversion.tigris.org/files/documents/15/38216/svn-python-1.4.4.win32-py2.4.exe。如果未安装,直接安装绑定安装包即可。以上都是subversion1.4.4版本
下载时注意,请下载Windows平台的二进制安装包(Windows binaries),不要下载源代码,那个需要重新编译,很麻烦,反正我不会。。。我给的链接都是安装包,大家下载安装即可(请首先安装Python)。
2. 安装
首先安装Python,然后其他几个安装程序能够自动识别Python的安装,从而只需要按照默认安装即可。默认安装目录是C:\Python24\,在本文中我使用默认路径安装。
3. 给我们的项目配置Trac环境
Trac环境就是一个存放wiki页面、tickets、报表、设置等等信息的后台存储器。一个环境在windows里就是一个目录,包含了配置文件和其他相关的文件、目录。
假设,我们有个项目,代号叫Angel,现在我们为这个项目配置Trac环境。
为了介绍方便,先介绍项目目录。假定项目配置都放在\SCM\Angel\下,建立的Subversion仓库在\SCM\Angel\SVN,我们将建立的Trac环境目录是\SCM\Angel\Angel_Trac\。我一般将\SCM目录放在非C盘,但这次我是在虚拟机上演示,虚拟机只有一个C盘,所以,所有的目录在C盘里。
总结下,我们要使用到的目录:
C:\Python24\(python环境目录),C:\SCM\Angel\SVN\(Angel项目的仓库),C:\SCM\Angel\Angel_Trac\(Angel项目的Trac环境目录)。
点击开始->运行,输入“cmd”,确认,打开Dos命令窗口,进入Python安装目录下的Scripts子目录。在我这里是C:\Python24\Scripts\。我们要使用trac-admin来创建并初始化一个Trac环境。先看看用法
用法: trac-admin </path/to/projenv> [command [subcommand] [option ...]]
我们要使用的command是
initenv
-- Create and initialize a new environment interactively(创建和初始化一个新的环境)
下面来创建和初始化Angel项目的Trac环境,如下图,绿色不分是我们输入的命令,黄色部分是我们在Dos窗口中需要交互的地方,白色窗口中给出了相应的解释。
Ok,我们在C:\SCM\Angel\Angel_Trac\建立了Trac环境,下面就是用tracd建立web站点,通过浏览器访问了。看图说话
现在,我们就使用tracd建立了项目的web站点,可以在浏览器中打开如下的网址进行访问
http://(trac环境所在的机器名或者ip地址):tracd使用的端口
比如,本例中使用的http://127.0.0.1:8001
注意,在此期间不要关闭tracd运行的窗口,因为关闭了窗口,tracd就停止运行了。难道我们需要一直开着tracd窗口吗?目前是的。但后面我会讲到将tracd封装成windows服务。
浏览器访问图片如下
上图中的“欢迎访问Angel项目"是我修改了wiki页。
ok,现在我们已经为项目Angel配置了Trac环境,并启动了web站点。今后,我们就可以使用浏览器来访问它了,可以使用ticket、roadmap、timeline,可以浏览subversion容器,还可以使用强大的wiki丰富我们的站点,共享知识。这些都很简单,大家多点点,多看看就明白了。
第一次如此认真在blog上写技术文章,希望能让大家看明白。如果有什么问题,可以留言或者email我,知无不言。我也会一直写下去的,个人觉得trac真是个好东西,希望大家从我的文章中能有所收益。
下一部分打算写基本使用,或是权限设置,不过可能得下周了。
参考文献:
Trac的官方指南,主要是其中的安装说明。
Subversion中文站中的一篇文章——《 Windows下安装配置集成Trac》。