Mercurial

De Breizh-Entropy
Aller à : navigation, rechercher


Préparation du serveur

Installation de base

apt-get install mercurial-server

Création d'un repository

root@server:~# mkdir /var/lib/mercurial-server/repos/projet
root@server:~# cd /var/lib/mercurial-server/repos/projet
root@server:/var/lib/mercurial-server/repos/projet# hg init
root@server:/var/lib/mercurial-server/repos/projet# chown hg:hg .

Créations d'utilisateurs

Avec SSH

Ces utilisateurs devront avoir un compte shell (ou UNIX) sur votre machine. Vous pouvez bien sûr les chrooter grâce à /etc/security/limits.conf

Au final ce sera l'utilisateur hg qui va servir à tout pusher. Le serveur fera la distinction grâce aux clés RSA que vous lui fournirez dans /etc/mercurial-server/keys/{root,user}/login_client/host_client. Vous devez donc générer une clé SSH avec le protocole de signature/authentification RSA sur le client :

login_client@host_client:~$ ssh-keygen -t rsa

Puis l'ajouter dans le serveur :

login_client@host_client:~$ ssh-copy-id -i ~/.ssh/id_rsa.pub serveur.tld

Ensuite vous devez dire à mercurial que cette clé peut être utilisée avec hg@. Il existe deux dossiers /etc/mercurial-server/keys/root/ et /etc/mercurial-server/keys/user/ en fonction des droits que vous voulez donner

root@server:~# mkdir -p /etc/mercurial-server/keys/{root,user}/login_client/host_client
root@server:~# cp /home/login_serveur/.ssh/authorized_keys /etc/mercurial-server/keys/{root,user}/login_client/host_client
root@server:~# chown hg -R /etc/mercurial-server/keys/
root@server:~# sudo -u hg /usr/share/mercurial-server/refresh-auth

Vous trouverez plus d'informations à propos de la gestion des utilisateurs sur http://dev.lshift.net/paul/mercurial-server/docbook.html

Avec HTTP(S)

Côté client

Initialisation

Il faut commencer par récupérer le dossier vide que nous venons de créer

login_client@host_client:~$ hg clone ssh://hg@server.tld/projet projet

Ajout de fichiers

Ensuite lorsque vous aurez créé des fichiers, il faudra les push

login_client@host_client:~/projet$ hg add fichier [fichier]

Si vous voulez vérifier où vous en êtes :

login_client@host_client:~/projet$ hg status

Puis vous devez tout envoyer en ligne :

login_client@host_client:~/projet$ hg commit -u user -m "Message expliquant les modifs"
login_client@host_client:~/projet$ hg push