Trac系列(1)：Windows下Trac的安装与基本配置

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》。

评论

2 楼 miaocbin 2009-02-19  

我使用的软件是trac0.11.3--stable相关配套软件。

1 楼 miaocbin 2009-02-19  

 帅哥你好，我参考官网上面的说明，也配置了个trac系统，基本过程和你的差不多，结果一样的，但是在配置login的时候出了问题，就是无法登陆，不知为何。有时间的话，向您请教一下。还望不吝赐教。
我的email：[e-mail]，
先谢谢了哈