Projet

Général

Profil

Git » Historique » Version 25

Laurent GUERBY, 31/07/2012 09:21

1 1 Antoine Lubineau
h1. Installation et utilisation d’un serveur Git
2 1 Antoine Lubineau
3 15 Antoine Lubineau
{{>toc}}
4 15 Antoine Lubineau
5 2 Antoine Lubineau
"Git":http://git-scm.com/ est un gestionnaire de versions décentralisé, libre et développé en C. À noter la traduction française du "Git community book":http://www.alexgirard.com/git-book/index.html.
6 1 Antoine Lubineau
7 17 Antoine Lubineau
La configuration se fera essentiellement au travers de "Gitolite":https://github.com/sitaramc/gitolite, qui permet de créer des dépôts, gérer les accès push/pull pour des accès en SSH, déléguer des droits, etc. @git-daemon@ permet de donner un accès au travers du protocole @git@, et "@cgit@":http://hjemli.net/git/cgit/ sera utilisé pour l’interface web et le pull en HTTP (ou HTTPS).
8 1 Antoine Lubineau
9 17 Antoine Lubineau
Les explications qui suivent ont été mises en pratique sur le serveur "@git.tetaneutral.net@":http://git.tetaneutral.net/ de Tetaneutral.net, donc avec une Debian Squeeze.
10 10 Antoine Lubineau
11 2 Antoine Lubineau
h2. "Gitolite":https://github.com/sitaramc/gitolite
12 1 Antoine Lubineau
13 23 Mehdi Abaakouk
h3. Installation de gitolite
14 23 Mehdi Abaakouk
15 24 Antoine Lubineau
Installation est très simple, sur la VM @git.tetaneutral.net@ :
16 24 Antoine Lubineau
* On créé l’utilisateur @git@ dédié
17 24 Antoine Lubineau
* On clone l’application Gitolite avec @git(1)@
18 24 Antoine Lubineau
* On installe Gitolite dans le répertoire personnel de l’utilisateur @git@
19 24 Antoine Lubineau
* On ajoute la clé SSH d’un des administrateurs
20 23 Mehdi Abaakouk
21 23 Mehdi Abaakouk
<pre>
22 23 Mehdi Abaakouk
useradd -m git
23 23 Mehdi Abaakouk
su - git
24 23 Mehdi Abaakouk
git clone git://github.com/sitaramc/gitolite.git
25 23 Mehdi Abaakouk
gitolite/src/gl-system-install
26 23 Mehdi Abaakouk
gl-setup -q sileht.pub
27 23 Mehdi Abaakouk
</pre>
28 23 Mehdi Abaakouk
29 24 Antoine Lubineau
Ensuite récupération sur mon ordi du dépôt @gitolite-admin@ :
30 23 Mehdi Abaakouk
31 23 Mehdi Abaakouk
<pre>
32 23 Mehdi Abaakouk
git clone git@git.tetaneutral.net:gitolite-admin
33 23 Mehdi Abaakouk
cd gitolite-admin
34 23 Mehdi Abaakouk
</pre>
35 4 Antoine Lubineau
36 1 Antoine Lubineau
h3. Configuration
37 1 Antoine Lubineau
38 17 Antoine Lubineau
Gitolite est *très* polyvalent, pour des usages poussés, se reporter à la "documentation en ligne":http://sitaramc.github.com/gitolite/.
39 17 Antoine Lubineau
40 8 Antoine Lubineau
Une fois Gitolite installé, la configuration des dépôts et des utilisateurs se fait *uniquement* au travers du dépôt @gitolite-admin.git@. Ce dépôt contient deux dossiers:
41 1 Antoine Lubineau
* @conf@ qui va contenir les fichiers de configuration (le plus souvent un seul, @gitolite.conf@) ;
42 1 Antoine Lubineau
* @keydir@, qui va stocker les clés publiques SSH des utilisateurs.
43 17 Antoine Lubineau
44 17 Antoine Lubineau
Example de configuration :
45 17 Antoine Lubineau
<pre>
46 17 Antoine Lubineau
repo    testing
47 17 Antoine Lubineau
        RW+     =   @all
48 17 Antoine Lubineau
</pre>
49 17 Antoine Lubineau
50 17 Antoine Lubineau
Dans cet example, tous les utilisateurs ayant une clé dans le dépôt @gitolite-admin@ ont tous les droits sur le dépôt @testing@.
51 17 Antoine Lubineau
52 18 Antoine Lubineau
Pour mettre à jour cette configuration, il suffit de la commiter et de la pusher, Gitolite appliquera les changements instantanément.
53 18 Antoine Lubineau
54 17 Antoine Lubineau
h4. Ajouter un utilisateur
55 17 Antoine Lubineau
56 17 Antoine Lubineau
Il suffit d’ajouter sa clé publique dans le dossier @keydir@, en la nommant soit @user.pub@, soit @user@machine.pub@, ce qui permet d’avoir plusieurs clés pour un même utilisateur. On peut avoir des sous-dossier dans @keydir@, c’est sans incidence sur le nommage.
57 25 Laurent GUERBY
58 25 Laurent GUERBY
<pre>
59 25 Laurent GUERBY
git add keydir/user.pub
60 25 Laurent GUERBY
</pre>
61 25 Laurent GUERBY
62 25 Laurent GUERBY
To check and commit push
63 25 Laurent GUERBY
64 25 Laurent GUERBY
<pre>
65 25 Laurent GUERBY
git diff master
66 25 Laurent GUERBY
git commit -a -m "add user"
67 25 Laurent GUERBY
git push
68 25 Laurent GUERBY
</pre>
69 25 Laurent GUERBY
70 17 Antoine Lubineau
Dans la configuration de Gitolite, l’utilisateur est désigné par @user@, et on peut faire des groupes :
71 17 Antoine Lubineau
<pre>
72 20 Antoine Lubineau
@mongroupe = user1 user2
73 1 Antoine Lubineau
</pre>
74 19 Antoine Lubineau
75 19 Antoine Lubineau
Et ensuite on peut donner des droits au groupe :
76 19 Antoine Lubineau
<pre>
77 19 Antoine Lubineau
repo    testing
78 20 Antoine Lubineau
        R     =   @mongroupe user3
79 19 Antoine Lubineau
</pre>
80 20 Antoine Lubineau
Le droit de lecture s’applique donc à @user1@, @user2@ et @user3@.
81 17 Antoine Lubineau
82 17 Antoine Lubineau
h4. Créer un dépôt
83 17 Antoine Lubineau
84 17 Antoine Lubineau
Il suffit de créer la ligne
85 17 Antoine Lubineau
<pre>
86 17 Antoine Lubineau
repo monrepo
87 17 Antoine Lubineau
</pre>
88 17 Antoine Lubineau
et de préférence d’y ajouter des utilisateurs :)
89 8 Antoine Lubineau
90 1 Antoine Lubineau
h2. git-daemon
91 1 Antoine Lubineau
92 15 Antoine Lubineau
h3. Installation
93 15 Antoine Lubineau
94 15 Antoine Lubineau
Rien à faire, @git-daemon(1)@ vient avec @git(1)@.
95 15 Antoine Lubineau
96 15 Antoine Lubineau
h3. Configuration
97 15 Antoine Lubineau
98 15 Antoine Lubineau
La configuration de @git-daemon@ se fait sous Debian dans @/etc/default/git-daemon@.
99 15 Antoine Lubineau
@git-daemon(1)@ peut être lancé avec l’option @--export-all@, mais c’est peu recommandé si on ne veut pas donner un accès en lecture à tous. On préférera créer dans chaque dépôt à exporter le fichier @git-daemon-export-ok@.
100 14 Antoine Lubineau
101 4 Antoine Lubineau
h2. "cgit":http://hjemli.net/git/cgit/
102 4 Antoine Lubineau
103 4 Antoine Lubineau
h3. Installation
104 2 Antoine Lubineau
105 1 Antoine Lubineau
Comme il n’y a pas de paquet Debian, il faut le compiler à la main. Au moment de la rédaction de ce guide, on ne pouvait pas compiler cgit contre la dernière version de Git (fonctionnel avec cgit 0.9.2.0 et Git 1.7.4).
106 1 Antoine Lubineau
<pre>
107 8 Antoine Lubineau
wget http://hjemli.net/git/cgit/snapshot/cgit-0.9.0.2.tar.bz2
108 8 Antoine Lubineau
wget http://arch.p5n.pp.ru/~sergej/dl/2011/git-1.7.4.tar.bz2
109 8 Antoine Lubineau
tar xf cgit-0.9.0.2.tar.bz2
110 8 Antoine Lubineau
cd cgit-0.9.0.2
111 8 Antoine Lubineau
tar xf -C git ../git-1.7.4.tar.bz2
112 1 Antoine Lubineau
</pre>
113 1 Antoine Lubineau
114 8 Antoine Lubineau
On peut modifier le @Makefile@ en mettant
115 8 Antoine Lubineau
<pre>CGIT_SCRIPT_PATH = /var/www</pre>
116 8 Antoine Lubineau
et
117 8 Antoine Lubineau
<pre>prefix = /usr/local/cgit</pre>
118 4 Antoine Lubineau
119 9 Antoine Lubineau
Ensuite :
120 9 Antoine Lubineau
<pre>
121 9 Antoine Lubineau
make
122 1 Antoine Lubineau
make install
123 1 Antoine Lubineau
</pre>
124 9 Antoine Lubineau
125 10 Antoine Lubineau
h3. Configuration de cgit
126 1 Antoine Lubineau
127 22 Antoine Lubineau
cgit récupère la liste des projets dans @~git/projects.list@. Cette liste est générée automatiquement par Gitolite pour les dépôts dont @gitweb@ a les droits en lecture (c’est une dénomination spécifique à gitolite, qui n’est pas incluse dans @@all@). Dans @gitolite.conf@ :
128 12 Antoine Lubineau
<pre>
129 12 Antoine Lubineau
repo    testing
130 12 Antoine Lubineau
        RW+     =   pipo
131 12 Antoine Lubineau
        R       =   gitweb
132 12 Antoine Lubineau
</pre>
133 10 Antoine Lubineau
134 13 Antoine Lubineau
Pour spécifier le propriétaire et la description d’un dépôt, voir le "manuel de gitolite":http://sitaramc.github.com/gitolite/confother_.html, section « specifying gitweb and daemon access ».
135 13 Antoine Lubineau
136 10 Antoine Lubineau
La configuration de @cgit@ se trouve dans @cgitrc(5)@ :
137 1 Antoine Lubineau
<pre>
138 10 Antoine Lubineau
virtual-root=/
139 10 Antoine Lubineau
project-list=/home/git/projects.list
140 16 Antoine Lubineau
scan-path=~git/repositories/
141 16 Antoine Lubineau
snapshots=tar.gz tar.bz2
142 16 Antoine Lubineau
enable-commit-graph=1
143 16 Antoine Lubineau
enable-tree-linenumbers=1
144 16 Antoine Lubineau
enable-index-links=1
145 16 Antoine Lubineau
enable-log-filecount=1
146 16 Antoine Lubineau
enable-log-linecount=1
147 16 Antoine Lubineau
max-stats=quarter
148 16 Antoine Lubineau
clone-prefix=http://git.tetaneutral.net git://git.tetaneutral.net
149 10 Antoine Lubineau
</pre>
150 10 Antoine Lubineau
151 21 Antoine Lubineau
h3. Configuration d’Apache
152 10 Antoine Lubineau
153 10 Antoine Lubineau
Pour que le serveur web ait les droits de lecture sur les dépôts, il faut ajouter l’utilisateur @www-data@ (ou l’utilisateur sous lequel tourne Apache) au groupe @git@ :
154 10 Antoine Lubineau
<pre>
155 6 Antoine Lubineau
usermod -aG git www-data
156 1 Antoine Lubineau
</pre>
157 1 Antoine Lubineau
158 11 Antoine Lubineau
Dans @~git/.gitolite.rc@, changer
159 1 Antoine Lubineau
<pre>
160 1 Antoine Lubineau
$REPO_UMASK = 0077;
161 1 Antoine Lubineau
</pre>
162 1 Antoine Lubineau
en
163 1 Antoine Lubineau
<pre>
164 1 Antoine Lubineau
$REPO_UMASK = 0027;
165 1 Antoine Lubineau
</pre>
166 11 Antoine Lubineau
Ce réglage n’étant valable que pour les nouveaux dépôts, il faut effectuer un @chmod -R g+rX@ sur les dépôts existants (*pas gitolite-admin.git* en général).
167 1 Antoine Lubineau
168 10 Antoine Lubineau
À mettre dans un _virtual host_ d’Apache :
169 1 Antoine Lubineau
<pre>
170 10 Antoine Lubineau
        DocumentRoot /var/www
171 10 Antoine Lubineau
        <Directory /var/www/>
172 10 Antoine Lubineau
                Addhandler cgi-script .cgi
173 10 Antoine Lubineau
                DirectoryIndex cgit.cgi
174 10 Antoine Lubineau
                Options +FollowSymLinks +ExecCGI
175 10 Antoine Lubineau
                AllowOverride None
176 10 Antoine Lubineau
                Order allow,deny
177 10 Antoine Lubineau
                allow from all
178 2 Antoine Lubineau
179 10 Antoine Lubineau
                RewriteEngine On
180 10 Antoine Lubineau
                RewriteBase /
181 10 Antoine Lubineau
                RewriteCond %{REQUEST_FILENAME} !-f
182 10 Antoine Lubineau
                RewriteCond %{REQUEST_FILENAME} !-d
183 10 Antoine Lubineau
                RewriteRule (.*) cgit.cgi/$1
184 10 Antoine Lubineau
                RewriteRule ^cgit.cgi$  cgit.cgi/
185 10 Antoine Lubineau
        </Directory>
186 10 Antoine Lubineau
</pre>