Установка и настройка mercurial и Apache через mod_wsgi в Debian / Ubuntu

Добавить в google.com bobrdobr.ru del.icio.us technorati.com linkstore.ru news2.ru memori.ru moemesto.ru


Mercurial - это распределённая система управления версиями (DCVS). Разрабатывалась специально для больших проектов. Таким образом, одной из отличительных особенностей Mercurial является скорость работы. БОльшая часть системы написана на Python, а чувствительные к производительности части - реализованы в качестве Python-расширений на C.

Наравне с традиционными возможностями систем контроля версий, Mercurial так же поддерживает функции для децентрализованной работы:

  • отсутствует понятие основного хранилища кода
  • ветвление (возможно вести несколько веток одного проекта и копировать изменения между ветками)
  • слияние репозиториев (чем и достигается «распределённость» работы).

Кроме того, Mercurial предоставляет Web-интерфейс, а так же встроенную систему подсказок. Большинство команд привычны для пользователей CVS.

Установка и настройка mercurial

Установка mercurial

Установка mercurial очень проста:

$ sudo aptitude install mercurial

Настройка mercurial

Далее, необходимо создать пользователя для mercurial и директории, где будут располагаться репозитории mercurial и виртуальный хост (последний необходим для настройки apache, см. далее):

# добавляем нового пользователя
$ sudo useradd hg
$ sudo mkdir /home/hg
$ sudo chown hg:hg /home/hg

# создаем директорим для репозиториев и для виртуального хоста
$ sudo -u hg mkdir /home/hg/rep /home/hg/www

Создание репозитория mercurial

После того, как пользователь создан, необходимо создать репозиторий, в котором будут храниться исходные коды:

# От имени пользователя hg создаем (hg init) репозиторий
$ sudo -u hg hg init /home/hg/rep/Debian.World.Ru

Попробуем что-нибудь сохранить в репозитории:

$ sudo su - hg
$ cd /home/hg/rep/Debian.World.Ru/

# создаем файл
$ echo "test mercurial cvs" > read.me

# убеждаемся, что mercurial "видит" новый файл
$ hg status
? read.me

# добавляем файл в репозиторий
$ hg add
adding read.me

# убеждаемся, что добавление файла выполнено
$ hg status
A read.me

# коммитим изменения
$ hg ci -m "init revision"
No username found, using 'hg@debian-world.ru' instead

Последняя строчка выглядит странновато, но волноваться не очем. Все изменения будут сохранены, а последняя строчка говорит лишь о том, что вместо имени ползователя будет использована строка "hg@debian-world.ru", то есть "логин@машина". Чтобы эта строка более не мозолила глаз, необходимо лишь сделать следующее:

$ echo "[ui]" > ~/.hgrc
$ echo "username = Debian.World.Ru Admin <debian.world.ru@gmail.com>" >> ~/.hgrc

Таким образом, mercurial будет "знать", кем подписываться при сохранении изменений.

Установка и настройка Apache, mod_wsgi

После того, как репозиторий создан, необходимо предоставить http-доступ к нему.

Установка Apache, mod_wsgi

Для этого необходимо установить http-сервер, например, Apache, а так же модуль для работы с python (в данном случае - mod_wsgi):

$ sudo aptitude install apache2 libapache2-mod-wsgi

Настройка Apache

Далее, необходимо создать виртуальный хост:

$ sudo touch /etc/apache2/sites-available/mercurial

Выглядеть он должен приблизительно следующим образом:

<VirtualHost *:80>
    ServerAdmin debian.world.ru@gmail.com
    ServerName hg.debianworld.ru
    DocumentRoot /home/hg/www/

    # настройки wsgi
    WSGIProcessGroup hg
    WSGIDaemonProcess hg user=hg group=hg threads=2 maximum-requests=1000

    # путь до скрипта, обрабатывающий wsgi
    WSGIScriptAlias / /home/hg/rep/hgwebdir.wsgi

    # ограничение доступа к репозиторию
    <Location />
        AuthType Basic
        AuthName "Restricted Files"
        AuthUserFile /home/hg/.hg.htpasswd
        Require valid-user
    </Location>
</VirtualHost>

Настройка mod_wsgi

После того, как создан виртуальных хост, необходимо создать скрипт wsgi, а так же файл пользователей, которым будет доступен репозиторий. Скрипт для wsgi можно располагать в любом месте, например, недалеко от репозитория:

$ sudo -u hg vim /home/hg/rep/hgwebdir.wsgi

Выглядеть он должен следующий образом:

#!/usr/bin/python
# -*- coding: utf-8 -*-

import os
os.environ['HGENCODING'] = 'utf-8'

from mercurial.hgweb.hgwebdir_mod import hgwebdir
from mercurial.hgweb.request import wsgiapplication

path = os.path.dirname(os.path.abspath(__file__))
application = hgwebdir(path+'/hgwebdir.conf')

Радом необходимо создать файл конфигации web-интерфейса репозитория:

$ sudo -u hg vim /home/hg/rep/hgwebdir.conf

Выглядеть он должен следующим образом:

[web]
style = coal

[paths]
DebianWorld.Ru = /home/hg/rep/Debian.World.Ru

После этого можно включить виртуальный хост и перегрузить apache:

$ sudo a2ensite mercurial
$ sudo /etc/init.d/apache2 reload

Настройка доступа к mercurial

На завершающей стадии настройки, необходимо создать файл паролей, указанный в описании виртуального хоста:

$ htpasswd -c /home/hg/.hg.htpasswd hgviewer

Теперь можно работать с репозитарием как через браузер, так и через командную строку, обращаясь к репозиторию по адресу: http://hg.debianworld.ru/DebianWorld.Ru/. Например:

# Просмотр репозитариев браузером
$ lynx http://hg.debianworld.ru/DebianWorld.Ru

# Копирование репозитория клиентом mercurial
$ hg clone http://hg.debianworld.ru/DebianWorld.Ru
destination directory: DebianWorld.Ru
http authorization required
realm: Restricted Files
user: 
password:

Вопросы по теме ...

Есть еще вопрос?