Gitolite

Gitolite est une réécriture de Gitosis, par Sitaram Chamarty. Il permet de gérer des dépôts Git à l'aide d'un utilisateur spécifique sur un serveur, en leur attribuant des utilisateurs ou groupes d'utilisateurs, des droits spécifiques comme la lecture, écriture, etc. Il possède un fichier de configuration complètement diffèrent qui permet le contrôle d'accès sur chaque branche, incluant des spécifications comme qui peut ou ne peut pas revenir sur une branche donnée.

Gitolite utilise évidement les clés publiques ssh pour l'ajout d'utilisateur, mais il est intéressant car il interdit ses utilisateurs de se connecter à un shell de l'utilisateur des dépôts. C'est l'un des points importants de sécurité auxquels répond Gitolite.

Gitolite utilise un utilisateur spécifique sur le serveur pour gérer les dépôts.

Dans cette documentation nous considérerons les termes suivants :

• server : serveur ;
• admin : administrateur du serveur ;
• git : utilisateur Git du serveur (s'il n'est pas créé, il peut l'être avec sudo adduser git).

Nous considérons donc que les utilisateurs admin et git sont sur server.

admin doit avoir un accès ssh autorisé sur le compte de l'utilisateur git. Si ce n'est pas le cas, sur server, créez une paire de clés (publique et privée) pour admin avec :

ssh-keygen

Puis ajoutez la clé publique aux clés autorisées de git avec :

ssh-copy-id -i ~/.ssh/id_rsa.pub git@localhost

Cette commande a pour effet d'ajouter votre clé au fichier ~/.ssh/authorized_keys de git.

Gitolite nécéssite évidement Git. Si ce n'est pas fait, installez donc le paquet git-core.

L'installation se fera depuis le dossier personnel de l'utilisateur admin de votre serveur server.

Récupérez les sources de Gitolite sur Github, avec :

git clone git://github.com/sitaramc/gitolite.git

Déplacez-vous dans le dossier des sources :

cd gitolite

Lancez à présent le script d'installation de Gitolite :

src/gl-easy-install git localhost admin

Cela signifie que vous lancez l'installation en utilisant git comme utilisateur contenant les dépôts Git, sur votre serveur (ici la machine sur laquelle vous êtes connectée, donc localhost représente server) et utilisez admin comme administrateur des dépôts.

Il vous sera demandé plusieurs choses au cours de l'exécution du script. Si vous n'êtes pas familié avec Git, utilisez les propositions par défaut.

La configuration de Gitolite est simple. Elle crée un dépôt de configuration nommé gitolite-admin sur le serveur, et son clône dans le répertoire personnel de admin. C'est dans celui-ci que nous configurerons nos dépôts. cette configuration comprend un fichier et un dossier :

• conf/gitolite.conf : fichier de configuration de Gitolite, contenant les dépôts, leurs utilisateurs/groupes et leurs droits associés ;
• keydir/ : dossier contenant les clés publiques des utilisateurs, sous la forme user_name.pub.

La configuration de Gitolite utilisant un dépôt Git spécifique, il sera nécessaire de commiter les changements effectués pour qu'ils prennent effet, c'est pour cela qu'il est nécessaire de se situer dans le dossier de configuration pour appliquer des changements.

Rendez-vous donc dans le dépôt gitolite-admin de votre utilisateur admin :

cd ~/gitolite-admin

Pour créer un dépôt, éditez votre fichier conf/gitolite.conf. Ce fichier se présente sous la forme :

repo repo1
    RW+            = admin

ce qui signifie que le dépôt repo1 (repository en anglais) admet un utilisateur (admin) qui possède les droits de lecture (R) et d'écriture (W).

Pour ajouter un dépôt my_repo, ajoutez donc :

repo my_repo
    RW+                 = user1 user2 user3

Une fois votre fichier édité, sauvegardé puis commitez les changements :

git add conf/gitolite.conf
git commit -m "add repository my_repo"
git push

my_repo sera automatiquement créé après le push dans /home/git/repositories/.

Pour ajouter un utilisateur, il suffit d'ajouter sa clé publique au dossier keydir/ dans un fichier nommé username.pub.

Pour ajouter par exemple l'utilisateur user1, crééz le fichier keydir/user1.pub contenant sa clé publique.

Une fois son fichier ajouté, commitez les changements :

git add keydir/user1.pub
git commit -m "add user user1"
git push

Pour ajouter un groupe, il suffit de le définir dans le fichier gitolite.conf. Éditez donc le fichier conf/gitolite.conf et ajoutez-y un groupe au début du fichier comme ceci :

@group1 = user1 user2 user3

Pour assigner un groupe à un dépôt, il suffit de le définir comme pour un utilisateur :

repo my_repo
    RW+                 = @group1

Puis commitez les changements avec :

git add conf/gitolite.conf
git commit -m "add group group1 and assign it to repo my_repo"
git push

Comme vous l'avez remarqué, les droits sont définis à des utilisateurs pour un dépôt donné. Il existe 3 types de droits :

• R : droit de lecture uniquement (l'utilisateur peut effectuer un git clone, etc) ;
• RW : droit de lecture et écriture (l'utilisateur peut effectuer un git clone, git push, etc) ;
• RW+ : droit de lecture et écriture, ainsi que les rewind permissions, c'est-à-dire le droit de supprimer des étapes du projet, comme par exemple le permet la commande git reset –hard HEAD^.

Pour permettre à n'importe qui d'accéder en lecture à votre dépôt, il vous faudra installer le git daemon.

Installez donc le paquet git-daemon-run.

Il faut indiquer au git daemon où sont situés les dépôts. Pour cela, éditez votre fichier /etc/sv/git-daemon/run.

Changez la ligne :

exec chpst -ugitdaemon git daemon --verbose --base-path=/var/cache /var/cache/git

par :

exec chpst -u git git daemon --verbose --base-path=/home/git/repositories

puis redémarrez le git daemon avec :

sudo /etc/init.d/git-daemon restart

Pour donner le droit de lecture au public pour un dépôt, il suffit d'attribuer le droit de lecture à l'utilisateur daemon pour ce dépôt. C'est-à-dire, ajouter la ligne :

R                   = daemon

à votre configuration, puis appliquer les changements, comme décrit dans la section Configuration.

Après avoir ajouter un utilisateur, celui-ci peut cloner un dépôt avec :

git clone git@server:my_repo

Dans le cas où l'utilisateur admin veut développer sur server, il doit cloner un dépôt avec :

git clone gitolite:my_repo

Si vous avez rendu accessible un dépôt au public, n'importe qui pourra cloner ce dépôt avec :

git clone git://server/my_repo

mkdir repo1
cd repo1
git init
git commit --allow-empty -m "initial repository"
git remote add origin git@server:repo1
git push origin master
git config push.default matching

• (en) page de Gitolite sur Github ;
• (en) Un exemple de fichier de configuration complet ;
• (fr) documentation de Git du wiki ;

Contributeurs : v0n.