**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Howto Mercurial
Sous Debian, pour installer Mercurial :
~~~
# aptitude install mercurial
~~~
## Utilisation
Configurer son client :
~~~
$ cat ~/.hgrc
[ui]
username = John Doe
verbose = True
~~~
Créer un dépôt :
~~~
$ mkdir -p foo && cd foo
$ hg init
~~~
Cloner un dépôt :
~~~
$ hg clone
destination directory: repo1
requesting all changes
adding changesets
adding manifests
adding file changes
added 40 changesets with 85 changes to 19 files
updating working directory
15 files updated, 0 files merged, 0 files removed, 0 files unresolved
~~~
Ajouter un nouveau fichier au dépôt :
~~~
$ hg add monfichier
~~~
Valider les modifications apportées au dépôt :
~~~
$ hg commit
Mon message de commit
HG: Enter commit message. Lines beginning with 'HG:' are removed.
HG: --
HG: user: user@host
HG: branch 'default'
HG: changed monfichier
~~~
Envoyer les modifications sur le dépôt :
~~~
$ hg push
pushing to
http authorization required
realm: Password protected
user: user@host
password:
searching for changes
adding changesets
adding manifests
adding file changes
added 1 changesets with 1 changes to 1 files
~~~
Récupérer la dernière version d'un dépôt :
~~~
$ hg pull
searching for changes
no changes found
~~~
Placer le _working directory_ dans une version particulière :
~~~
$ hg update 19
9 files updated, 0 files merged, 4 files removed, 0 files unresolved
~~~
## HGWEB
HGWEB sert à naviguer dans les dépôts par une interface web, mais surtout
à utiliser Mercurial via HTTP.
~~~
# aptitude install libapache2-mod-wsgi
# mkdir /home/hg
# cp /usr/share/doc/mercurial-common/examples/hgweb.wsgi /home/hg/
# sed -i 's@/path/to/repo/or/config@/home/hg/hgweb.config@' /home/hg/hgweb.wsgi
# cat /home/hg/hgweb.config
[paths]
test = /home/hg/test
coin = /home/hg/coin
[web]
#allow_push = *
baseurl = /
push_ssl = false
# chown -R www-data:www-data /home/hg
~~~
Il reste maintenant à activer un VirtualHost.
Par exemple avec un authentification LDAP :
~~~{.apache}
ServerName hg.example.com
DocumentRoot /home/hg/www
#WSGIDaemonProcess hg user=hg group=hg processes=2 maximum-requests=5000
WSGIScriptAlias / /home/hg/hgweb.wsgi
Require all granted
Options ExecCGI FollowSymlinks
AuthType Basic
AuthName "Reserved access"
AuthBasicProvider ldap
AuthzLDAPAuthoritative on
AuthLDAPURL "ldap://ldap.example.com:389/ou=people,dc=example,dc=com?uid?sub?(objectClass=*)"
Require ldap-group cn=hg,ou=group,dc=example,dc=com
Require ldap-group cn=hg-push,ou=group,dc=example,dc=com
~~~
Il reste à gérer les droits du répertoire /home/hg devant appartenir à l'utilisateur web
(par exemple via ACL ou Apache-ITK).
## FAQ
* Lorsque je push en SSH, j'obtiens :
~~~
remote: abandon : There is no Mercurial repository here (.hg not found) !
abandon : no suitable response from remote hg !
~~~
Il faut mettre un double slash (//) après le hostname. Voir notamment
* Lorsque je push en HTTP, j'obtiens :
~~~
ssl required
~~~
Il faut passer en HTTPS. Si vraiment, on veut le faire en HTTP non sécurisé, il faut le forcer au niveau du serveur via _push_ssl = false_
Voir