在Windows使用apache搭建Mercurial版本控制服务

Windows使用apache搭建Mercurial版本控制服务
【CCY 】【2011-01-05】
说明：资料参考网上的资料加上本人配置过程总结，希望可以帮到需要的网友
第一部分：安装配置
一准备工作，安装以下软件
1Mercurial v1.6（Mercurial主文件）[]
2 Python v2.6（Python）
3 XAMPP v1.7.3（apache服务器）
4 TortoiseHG（Mercurial可视化的客户端）
说明：
（1）最好是使用没有空格的路径！例如c:\Program Files这样的路径最好不要用，不然可能出现乱七八糟的错误。

（2）在配置文件中路径使用“/” 或者使用”\\”，例如“C:/xampp/xampp/htdocs/”（3）Python安装目录和Mercurial安装目录必须加入到环境变量PATH中
可执行命令python和hg来测试是否路径正确。

二创建一个仓库
1 创建
使用TortoiseHG在某个目录创建repositorie，我的目录是F:\hg
三配置
1 配置Mercurial环境（需要解压和复制模版）
（1）从Mercurial中找到library.zip，解压到一个目录，我这里是解压到C:\\Mercurial\\library目录。

(注意是Mercurial里的，不是TortoiseHG的library.zip，不然会出错)
（2）把Mercurial中templates整个目录同样复制到C:\\Mercurial\\library下。

2在xampp安装目录htdocs下，建立一个hg文件夹，作为对外的HTTP访问目录
3在hg目录下，建立一个hgwebdir.cgi文件，把下面的内容拷贝进去
#!C:/Python26/python.exe
#
# An example CGI script to export multiple hgweb repos, edit as necessary #
import sys
sys.path.insert(0, "C:\\Mercurial\\library")
from mercurial import demandimport;
demandimport.enable()
import cgitb
cgitb.enable()
#import os
#os.environ["HGENCODING"] = "UTF-8"
from mercurial.hgweb.hgwebdir_mod import hgwebdir
import mercurial.hgweb.wsgicgi as wsgicgi
application = hgwebdir('hgweb.config')
unch(application)
说明：
（1）这个CGI就是HTTP访问的跟文件，从这个文件配置的路径来访问f:/hg仓库目录（2）第一行中的#!C:/Python26/python.exe改为你python.exe所在的路径。

（3）sys.path.insert(0, “C:\\Mercurial\\library”)这句中的
C:\\Mercurial\\library是上面把library.zip解压的目录
（4）application = hgwebdir('hgweb.config')说明我们还需要一个配置文件hgweb.config来指定f:/hg仓库目录的位置和相关配置。

（5）
4在hg目录下，建立一个hgweb.config文件，内容如下：
[collections]
f:/hg = f:/hg
[web]
allow_push = *
push_ssl = false
style = gitweb
说明：将[collections]中目录指定为你自己的目录。

这里以后可以配置多个仓库
5配置apache的配置文件httpd.conf
（1）打开ampp/apache/conf/httpd.conf文件，在最末尾加入
# 版本管理
ScriptAliasMatch ^/hg(.*) C:/xampp/xampp/htdocs/hg/hgwebdir.cgi$1
<Directory "C:/xampp/xampp/htdocs/hg/">
Options ExecCGI FollowSymLinks
#去掉SSLRequireSSL的#号就强迫使用ssl来访问
#SSLRequireSSL
</Directory>
说明：
C:/xampp/xampp/htdocs/hg/hgwebdir.cgi修改为你的hgwebdir.cgi所在的路径。

这样Apache就可以通过路径访问hg目录了，例如：https://localhost/hg/访问
6调试
Premature end of script headers: hgwebdir.cgi。

（1）如果遇到这个问题，建议把它改为hgwebdir.py，用python运行检查一下出现什么错误，注意路径中有空格要用双引号括起来，路径用”/”来隔开。

（2）最终会有个SCRIPT的错误：KeyError，这个没关系，把它改回hgwebdir.cgi 就可以从网页上浏览了。

第二部分用户权限配置
一简介：
步骤如下：
1 创建用户文件
2 启用apache的http用户控制
3 试用上两步创建的用户，配置单个仓库的访问权限
二配置方法
1 用htpasswd.exe建立用户密码文件
htpasswd.exe在apache的bin目录可以找到，使用方法主要有
htpasswd -c 文件名用户名 //参数-c创建密码文件，输入后会提示你输入密码
htpasswd 文件名用户名 //如果用户名一样会更新密码
举个例子，我现在要建两个用户
这时会得到一个hguser的文件，把它放到hg目录下
2 修改httpd.conf配置，启用http用户设置，在文件最后添加一下内容
<Location /hg>
AuthType Basic
AuthName "Mercurial repositories"
AuthUserFile " C:/xampp/xampp/htdocs/hg/hguser"
Require valid-user
</Location>
说明：
（1）<Location /hg>指定对那一个URL路径试用验证
（2）"C:/xampp/xampp/apache/conf/hguser"指定了用户文件
（3）Require valid-user这句启用验证。

不要使用，本人测试这样配置的话，直接提示无权限访问，不会弹出用户输入框
2 针对Hg仓库设置用户权限，有了上2部分，我们就有了可以使用的用户和密码
在服务器存放项目的文件中，在.hg目录新建一个hgrc文件，里面可以配置为
[web]
allow_push = *
push_ssl = false
allow_read = ccy
这样这个仓库就只允许ccy用户读取了，相关配置还有deny_read，allow_push 等等，可以自行查找。

第三部分：本人配置遇到过的问题
一路径配置错误
（1）hgwebdir.cgi中路径配置错误, 网页访问提示：
解决: 运行cmd
直接运行命令python hgwebdir.cgi。

我运行的是改名后的。

发现找不到 Mercurial，说明是hgwebdir.cgi文件中
sys.path.insert(0, "C:\\Mercurial\\library")
这句路径不正确，修改后解决
（2）忘了把Mercurial下的Templates目录复制到C:\\Mercurial\\library（这个看配置的第一步）。

现象：网页访问返回：
将hgwebdir.cgi修改为hgwebdir.py 运行，提示如下：
有个RuntimeError: No hgweb templates found in []
Mercurial下的Templates目录复制到C:\\Mercurial\\library后解决。

（3）配置权限的时候httpd.conf文件中，进行了如下的配置
不要使用，本人测试这样配置的话，直接提示无权限访问，不会弹出用户输入框<LimitExcept GET>
Require valid-user
</LimitExcept>
结果，不弹出用户输入框。

去掉第一行和第三行，只剩下Require valid-user后好用。