J'ai commencé à regarder du côté des SCM[1] (marre de la gestion CPOLD ;-) il y a quelque temps déjà, et m'était tout d'abord arrêté sur Subversion [2] étant novice en la matière. Il s'est vite révélé peu adapté à ma pratique : "développement" sur plusieurs machines pas toujours online, et pas de serveur dédié toujours en ligne pour stocker mes dépôts. Depuis peu, ce dernier problème s'est réglé (merci Gandi Hébergement[3]) mais pour autant, j'ai abandonné Subversion pour Mercurial, un gestionnaire de code source distribué.
Je ne vais pas entrer ici dans les détails sur les caractéristiques d'un gestionnaire de code source distribué, ses avantages, ou même sur une présentation détaillée sur Mercurial et son mode de fonctionnement (je vous laisse visiter le site officiel pour cela). Je vais uniquement présenter des détails sur la configuration que j'ai mise en place afin de parvenir à partager aisément des dépôts différents via http et https, ainsi que comment faire pour autoriser la mise à jour de ceux-ci via https.
présentation des dépôts Mercurial sur le web
Imaginons que vos dépôts soient stockés dans /mercurial et que vous vouliez pouvoir donner un accès en lecture sur le web, à l'adresse http://hg.domain.tld. Nous allons configurer Apache et Mercurial pour ce faire.
Tout d'abord, nous allons créer un emplacement pour les fichiers web et le script CGI en Python pour Mercurial. Prenons /var/www/domain.tld/hg. Créons à cet endroit un répertoire hgweb dans lequel nous allons placer le script hgwebdir.cgi que vous pouvez trouver sur votre système (sous Debian /usr/share/doc/mercurial/examples/hgwebdir.cgi) ou sur le site de Mercurial.
Éditez ce fichier pour avoir à la fin :
def make_web_app():
return hgwebdir("/etc/mercurial/hgweb.config")
Nous allons ensuite créer le fichier /etc/mercurial/hgweb.config avec un contenu comme suit :
[paths]
depot1 = /mercurial/depot1
depot2 = /mercurial/depot2
On peut également utiliser la directive [collections] pour partager une hiérarchie de dépôts mais nous partons du principe que l'on veut contrôler précisément ce que l'on partage.
À partir de là, il nous reste à configurer Apache. Créez un fichier /etc/apache2/sites-available/hg.domain.tld afin de déclarez votre VirtualHost. Voici en exemple mon fichier
NameVirtualHost *:80
<VirtualHost *:80>
ServerAdmin webmaster@hg.domain.tld
ServerName hg.domain.tld
DocumentRoot /var/www/domain.tld/hg
<Directory /var/www/domain.tld/hg/>
Options FollowSymLinks +ExecCGI
AddHandler cgi-script .cgi
DirectoryIndex hgweb/hgwebdir.cgi
AllowOverride None
RewriteEngine on
RewriteBase /hgweb
RewriteRule ^$ hgwebdir.cgi [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule (.*) hgwebdir.cgi/$1 [QSA,L]
</Directory>
LogLevel warn
ErrorLog /var/log/apache2/hg.domain.tld-error.log
. CustomLog /var/log/apache2/hg.domain.tld-access.log combined
ServerSignature Off
</VirtualHost>
Notez ici les règles de réécriture qui permettent de faire disparaître hgwebdir.cgi de vos URL. C'est ce qui m'a pris le plus de temps à trouver avant de tomber sur cette doc.
Activez votre nouveau "site" ainsi que les modules Apache dont vous aurez besoin
# a2ensite hg.domain.tld
# a2enmod mod_python
# a2enmod rewrite
# /etc/init.d/apache2 restart
Vous pouvez maintenant aller voir http://hg.domain.tld et parcourir vos dépôts Mercurial depot1 et depot2
partager des dépôts différents par https
Tout ça, c'est très bien, mais on aimerait également pouvoir avoir accès à certains dépôts que l'on ne veut pas donner en lecture à tout internet : des dépôts privés en somme. Nous allons donc partager ceux-ci sur un site sécurisé avec authentification.
Nous allons donc retourner dans notre répertoire /var/www/domain.tld/hg/hgweb, copier hgwebdir.cgi en hgwebdirssl.cgi et éditez ce fichier pour avoir :
def make_web_app():
return hgwebdir("/etc/mercurial/hgwebssl.config")
Créons le fichier /etc/mercurial/hgwebssl.config avec :
[paths]
depot1 = /mercurial/depot1
depot2 = /mercurial/depot2
depot_prive3 = /mercurial/depot3
depot_prive4 = /mercurial/depot4
Et retournons éditer /etc/apache2/sites-available/hg.domain.tld pour y ajouter :
# en haut du fichier
NameVirtualHost *:443
# à la fin du fichier
<VirtualHost *:443>
ServerAdmin webmaster@hg.domain.tld
ServerName hg.domain.tld
DocumentRoot /var/www/domain.tld/hg
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/hg.domain.tld.pem
SSLCertificateKeyFile /etc/apache2/ssl/hg.domain.tld.key
<Directory /var/www/domain.tld/hg/>
Options FollowSymLinks +ExecCGI
AddHandler cgi-script .cgi
DirectoryIndex hgweb/hgwebdirssl.cgi
AllowOverride None
RewriteEngine on
RewriteBase /hgweb
RewriteRule ^$ hgwebdirssl.cgi [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule (.*) hgwebdirssl.cgi/$1 [QSA,L]
AuthUserFile /etc/mercurial/hgweb.htpasswd
AuthGroupFile /dev/null
AuthName "hg.domain.tld Mercurial repository"
AuthType Basic
# <LimitExcept GET OPTIONS>
Require valid-user
# </LimitExcept>
</Directory>
ErrorLog /var/log/apache2/hg.domain.tld-error.log
LogLevel warn
CustomLog /var/log/apache2/hg.domain.tld-access.log combined
ServerSignature Off
</VirtualHost>
On retrouve ici les directives rewrite que nous avons utilisé dans la première partie, à la différence qu'elles pointent vers le CGI spécifique à notre configuration SSL, et quelques directives spécifiques justement à https/SSL. Bien évidemment, il vous faudra créer un fichier de mots de passe (nommé ici hgweb.htpasswd) avec :
# htpasswd -c /etc/mercurial/hgweb.htpasswd hguser
pour autoriser l'utilisateur hguser.
Notez les directives <LimitExcept GET OPTIONS> qui, si elles sont décommentées, permettent à tout le monde de visualiser les dépôts tout en demandant une authentification pour interagir via les commandes de Mercurial (clone, pull, push...).
Rechargez la configuration d'Apache et regardez la différence entre http://hg.domain.tld et https://hg.domain.tld
autoriser la mise à jour des dépôts via https
Pour autoriser le push via https, une fois le travail ci-dessus effectué, il suffit d'éditer la configuration des dépôts en modifiant le fichier .hg/hgrc de chaque projet. Éditez-le ou créez-le et insérez les lignes suivantes :
[web]
allow_push = hguser
utilisation
Voilà c'est fait, vous pouvez maintenant interagir très simplement avec vos dépôts Mercurial.
Pour cloner un dépôt public
$ hg clone http://hg.domain.tld/depot1
Pour cloner un dépôt privé
$ hg clone https://hguser@hg.domain.tld/depot_prive3
Pour mettre à jour (push) ce même dépôt
$ hg push https://hguser@hg.domain.tld/depot_prive3
J'ajouterais que le plus dur est de gérer finement les droits d'accès aux divers fichiers nécessaires au bon fonctionnement de cette configuration. Pour faire simple, comme d'habitude, laissez le minimum de droits sur les fichiers de configuration (appartenance à l'utilisateur www-data et lecture pour lui), et pour les dépôts j'ai choisi la solution un groupe devel pour mon utilisateur principal ainsi que www-data et les droits pour ce groupe.
Alors, pourquoi ce balladeur mp3 d'une marque que personne ne connait ? Tout d'abord, parce que c'est le meilleur baladeur mp3 existant... (il a par exemple été élu 