<note warning>work in progress</note>

====== Mise en place d'un système de contrôle de version GIT sous unbuntu server 10.10 ======

{{:infra:infra:git:git-logo.png|}}


===== Introduction =====

Git est un logiciel de gestion de versions décentralisé. C'est un logiciel libre créé par Linus Torvalds, le créateur du noyau Linux, et distribué sous la GNU GPL version 2.

  * Le site officiel de git est disponible à cette adresse : http://git-scm.com/
  * Une trés bonne ressource documentaire sur git : http://progit.org/book/
===== Objectifs =====

L'objectif de ce tutoriel est de mettre en place rapidement et simplement un serveur git décentralisé. Nous aurons la possibilité de :

  * parcourir les projets grâce à une interface web (gitweb)
  * cloner un projet public avec le protocole git (git-daemon)
  * cloner et travailler sur un projet de manière sécurisée (gitolite)

Enfin nous verrons l'intégration de notre serveur avec redmine.

===== Installation de git, gitolite et gitweb=====

C'est la partie la plus simple de ce tuto :

<code>
aptitude install git-core gitolite gitweb
</code>


===== Utilisation au quotidien =====
==== Administrer le serveur git ====

L'administration (attribution des droits, création des dépôts ....) se fait entièrement à distance. Il n'est plus besoin d'intervenir sur le serveur en lui même. C'est la magie de gitosis qui permet d'administrer le serveur git via un ... dépôt git.

L'administrateur sera donc l'utilisateur dont on a utilisé la clé publique pour initialiser gitosis.

<note>
Ce qui suit se passe intégralement sur le poste de travail et plus sur le serveur git
</note>

=== Récupération du dépôt gitosis-admin ===

<code>
git clone git@votreserveur:gitosis-admin.git && cd gitosis-admin
</code>

cela nous donne l'arborescence suivante :
<code>
`-- gitosis-admin
    |-- gitosis.conf
    `-- keydir
        `-- user@host.pub
</code>

le répertoire keydir recevra les clé publique des utilisateurs autorisés a accéder aux dépôts
le fichier gitosis.conf servira à configurer les acl et les dépots.

=== Ajouter un dépôt et un utilisateur autorisé à écrire dans ce dépôt ===

Cela est redoutablement simple !

  * Nous devons tout d'abord récupérer la clé publique de l'utilisateur et la placer dans le répertoire keydir
  * Ensuite nous allons éditer le fichier gitosis.conf et rajouter une section décrivant le dépot
<code>
[repo monprojet]
description = description du projet
owner = Propriétaire du dépot (informatif)
<code>
  * Ensuite nous définissons les droits de l'utilisateur sur ce dépôt
[group monprojet]
writable = monprojet
members = user@host
</code>

**writable** donne les droits d'écriture sur le dépôt **monprojet**

**members** est une liste d'utilisateurs séparés par des espaces (doit correspondre au fichier clé publique placé précédemment dans le répertoire keydir sans l'extension .pub)

Voila notre configuration est terminée. Il ne reste plus qu'a ajouter le fichier clé publique au dépot local

<code>
git add keydir/user@host.pub
git commit -am "Ajout du dépôt monprojet et autorisations pour user@host"
</code>

Enfin on "pousse" la configuration vers le serveur git
<code>
git push
</code>

Pour l'administrateur c'est tout ! Voyons maintenant comment l'utilisateur va créer son dépot.

=== Création du dépot par l'utilisateur ===

<note>
Manipulations faites par l'utilisateur depuis son poste de travail
</note>

L'utilisateur à donc fait sa demande à l'administrateur pour pouvoir héberger son dépôt sur le serveur git. 
Il doit maintenant initialiser son dépôt sur son poste de travail

<code>
mkdir monprojet
cd monprojet
git init
</code>

Il faut maintenant déclarer le dépôt distant

<code>
git remote add origin git@monserveur:monprojet.git
</code>

Enfin on pousse notre dépot vers le serveur

<code>
git push origin master:refs/heads/master
</code>

===== Ressources en ligne =====

  * [[http://progit.org/book/|PRO GIT]] : Un livre en ligne sur git et ses possibilités ! 
  * [[http://eagain.net/gitweb/?p=gitosis.git;a=blob;f=README.rst| Gitosis README]] : Le fichier README de gitosis
  * [[http://git-scm.com/| Site officiel de GIT]]