5—Ubuntu下apache+mod_wsgi搭建hg server

在《[Publishing Mercurial Repositories](http://mercurial.selenic.com/wiki/PublishingRepositories)》这篇文章中介绍了很多种将我们自己的hg代码库发布/公开的办法。其中最轻量型的办法是使用hg自带的web server发布，只需要在代码库目录下执行命令hg serve就搞定。但是这只是一个临时的方案，如果想要更健壮更安全，官网还是建议使用hgweb脚本+Web server（apache，IIS等）的方式。 查看资料后，我权衡利弊，准备以《[Serving Mercurial repositories with Apache and mod_wsgi](http://mercurial.selenic.com/wiki/modwsgi)》为蓝本再结合其他教程和实践，来搭建自己的hg server供局域网中的小伙伴使用。 #### 1.工具 mod_wsgi:apache和python沟通的桥梁。 apache2：这个家伙仍然在web server领域引领风骚。 python:2.7版本足以。 mercurial：这是我们的主角。 hgweb.wsgi：mercurial给我们提供的。 linc注：我是这WEB方面的门外汉，对cgi和wsgi等概念是一无所知，之前搭建Scrum环境是在Windows下使用傻瓜似工具，根本没机会配置apache。因此，接下来的工作令我苦不堪言。有不足之处也在所难免。更请高手指正。 #### 2.安装 我在Ubuntu下使用apt-get install安装这些工具，十分顺利，闲言少叙。 *sudo apt-get install apache2* 完成后即使不做任何配置，在浏览器中输入localhost，也会出现“It works!”。那么apache就算安装成功。 *sudo apt-get install libapache2-mod-wsgi* 安装后在/usr/lib/apache2/modules/目录下会发现多了mod_wsgi.so ~~~ lrwxrwxrwx 1 root root     15 Nov 19 00:50 mod_wsgi.so -> mod_wsgi.so-2.7   -rw-r--r-- 1 root root 152064 Nov 19 00:50 mod_wsgi.so-2.7   ~~~ #### 3.关于apache目录这件小事 1）/var/www 这个目录是用来放置我们的网站的入口，默认这里会有个index.html,刚才我们打开localhost出现的界面就是这个index.html了。后续我们会在这个目录下做文章。 2）/etc/apache2 我们要在这里做apache的配置，重点文件有apache2.conf,httpd.conf,以及sites-available下的default。 #### 4.配置 按照教程的例子，我也以虚拟主机 “hg.example.net"来完成整个配置。 **第一步，加载mod_wsgi** 我们的配置（user configurations）在/etc/apache2/httpd.conf中进行， 加载mod_wsgi只需添加LoadModule wsgi_module modules/mod_wsgi.so 即可。 linc注：后来我又将此句注释掉，发现依然运行正常。 **第二步，配置apache** 依例子的要求，我们要做以下工作。 1）在www下创建新文件夹 /var/www/vhosts/hg.example.net/cgi-bin /var/www/vhosts/hg.example.net/htdocs 2)修改/etc/apache2/sites-avaiable/default 变成如下： ~~~        ServerName hg.example.net       DocumentRoot /var/www/vhosts/hg.example.net/htdocs          WSGIScriptAliasMatch ^(.*)$ /var/www/vhosts/hg.example.net/cgi-bin/hgweb.wsgi$1                     Options FollowSymlinks           DirectoryIndex index.html           AllowOverride None           Order allow,deny           Allow from all                            Options ExecCGI FollowSymlinks              AddHandler wsgi-script .wsgi           AllowOverride None           Order allow,deny           Allow from all             ~~~ **第三步，配置Mercurial** 1）将hgweb.wsgi文件复制到/var/www/vhosts/hg.example.net/cgi-bin/ sudo cp /usr/share/doc/mercurial-common/examples/hgweb.wsgi /var/www/vhosts/hg.example.net/cgi-bin/ 修改成如下： ~~~ # Path to repo or hgweb config to serve (see 'hg help hgweb')   config = "/var/www/vhosts/hg.example.net/cgi-bin/hgweb.config"      # enable demandloading to reduce startup time   from mercurial import demandimport; demandimport.enable()      from mercurial.hgweb import hgweb   application = hgweb(config)   ~~~ 2）hgweb.config 在/var/www/vhosts/hg.example.net/cgi-bin/新加文件hgweb.config 内如如下： ~~~ [web]   style = coal      [paths]   / = /var/www/vhosts/hg.example.net/htdocs/**   ~~~ 重启apache： *sodu /etc/init.d/apache2 restart* 到此，《Serving Mercurial repositories with Apache and mod_wsgi》便结束了。 **第四步，创建hg代码仓库** 将代码放在哪里？一直没有好主意，看到有人将其放在/var下了，姑且我也这样吧。 新建目录/var/hg/repos/test, *mkdir /var/hg/repos/test; cd /var/hg/repos/test; hg init* 一个临时的代码仓库就创建完了，下面如何跟server联系在一起呢？ 回过头来，我们还要修改一下hgweb.config,加入下面两句： ~~~ [collections]   /var/hg = /var/hg   ~~~ 重启apache后，在浏览器中输入：localhost/repos/test 你的代码库就出现了呢。这样就说明我们的工作完成了。你可能要问，直接在浏览器中输入hg.example.net不也可以吗？是这样的，但是我们还要做一项工作，在/etc/hosts文件中加入127.0.0.1   hg.example.net 才行. 好吧，先庆祝一下，下文再说代码提交遇到的问题以及身份认证问题。 参考： http://mercurial.selenic.com/wiki/PublishingRepositories http://mercurial.selenic.com/wiki/modwsgi http://stackoverflow.com/questions/12347373/how-to-setup-mercurial-server-in-ubuntu-to-serve-60-repositories http://thepanz.netsons.org/post/ubuntu-10-4-and-mercurial-server-apache2-mod_wsgi/comment-page-1 http://blog.sina.com.cn/s/blog_4567bb800100whho.html http://blog.csdn.net/tony1130/article/details/5326015 http://blog.csdn.net/kongdaoxian/article/details/7944872