Trac系列(1)：Windows下Trac的安装与基本配置
2007-07-06 16:02
|
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站点，通过浏览器访问了。看图说话 
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》。 |
扫一扫
1752
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
