Projet

Général

Profil

Git » Historique » Version 29

Antoine Lubineau, 29/06/2013 15:28

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 28 Laurent GUERBY
Lire aussi http://homepages.laas.fr/matthieu/cours/git.pdf
12 28 Laurent GUERBY
13 2 Antoine Lubineau
h2. "Gitolite":https://github.com/sitaramc/gitolite
14 1 Antoine Lubineau
15 23 Mehdi Abaakouk
h3. Installation de gitolite
16 23 Mehdi Abaakouk
17 24 Antoine Lubineau
Installation est très simple, sur la VM @git.tetaneutral.net@ :
18 24 Antoine Lubineau
* On créé l’utilisateur @git@ dédié
19 24 Antoine Lubineau
* On clone l’application Gitolite avec @git(1)@
20 24 Antoine Lubineau
* On installe Gitolite dans le répertoire personnel de l’utilisateur @git@
21 24 Antoine Lubineau
* On ajoute la clé SSH d’un des administrateurs
22 23 Mehdi Abaakouk
23 23 Mehdi Abaakouk
<pre>
24 23 Mehdi Abaakouk
useradd -m git
25 23 Mehdi Abaakouk
su - git
26 23 Mehdi Abaakouk
git clone git://github.com/sitaramc/gitolite.git
27 23 Mehdi Abaakouk
gitolite/src/gl-system-install
28 23 Mehdi Abaakouk
gl-setup -q sileht.pub
29 23 Mehdi Abaakouk
</pre>
30 23 Mehdi Abaakouk
31 24 Antoine Lubineau
Ensuite récupération sur mon ordi du dépôt @gitolite-admin@ :
32 23 Mehdi Abaakouk
33 23 Mehdi Abaakouk
<pre>
34 23 Mehdi Abaakouk
git clone git@git.tetaneutral.net:gitolite-admin
35 23 Mehdi Abaakouk
cd gitolite-admin
36 23 Mehdi Abaakouk
</pre>
37 4 Antoine Lubineau
38 1 Antoine Lubineau
h3. Configuration
39 1 Antoine Lubineau
40 17 Antoine Lubineau
Gitolite est *très* polyvalent, pour des usages poussés, se reporter à la "documentation en ligne":http://sitaramc.github.com/gitolite/.
41 17 Antoine Lubineau
42 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:
43 1 Antoine Lubineau
* @conf@ qui va contenir les fichiers de configuration (le plus souvent un seul, @gitolite.conf@) ;
44 1 Antoine Lubineau
* @keydir@, qui va stocker les clés publiques SSH des utilisateurs.
45 17 Antoine Lubineau
46 17 Antoine Lubineau
Example de configuration :
47 17 Antoine Lubineau
<pre>
48 17 Antoine Lubineau
repo    testing
49 17 Antoine Lubineau
        RW+     =   @all
50 17 Antoine Lubineau
</pre>
51 17 Antoine Lubineau
52 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@.
53 17 Antoine Lubineau
54 18 Antoine Lubineau
Pour mettre à jour cette configuration, il suffit de la commiter et de la pusher, Gitolite appliquera les changements instantanément.
55 18 Antoine Lubineau
56 17 Antoine Lubineau
h4. Ajouter un utilisateur
57 17 Antoine Lubineau
58 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.
59 25 Laurent GUERBY
60 25 Laurent GUERBY
<pre>
61 25 Laurent GUERBY
git add keydir/user.pub
62 25 Laurent GUERBY
</pre>
63 25 Laurent GUERBY
64 25 Laurent GUERBY
To check and commit push
65 25 Laurent GUERBY
66 25 Laurent GUERBY
<pre>
67 25 Laurent GUERBY
git diff master
68 25 Laurent GUERBY
git commit -a -m "add user"
69 25 Laurent GUERBY
git push
70 25 Laurent GUERBY
</pre>
71 25 Laurent GUERBY
72 17 Antoine Lubineau
Dans la configuration de Gitolite, l’utilisateur est désigné par @user@, et on peut faire des groupes :
73 17 Antoine Lubineau
<pre>
74 20 Antoine Lubineau
@mongroupe = user1 user2
75 1 Antoine Lubineau
</pre>
76 19 Antoine Lubineau
77 19 Antoine Lubineau
Et ensuite on peut donner des droits au groupe :
78 19 Antoine Lubineau
<pre>
79 19 Antoine Lubineau
repo    testing
80 20 Antoine Lubineau
        R     =   @mongroupe user3
81 19 Antoine Lubineau
</pre>
82 20 Antoine Lubineau
Le droit de lecture s’applique donc à @user1@, @user2@ et @user3@.
83 17 Antoine Lubineau
84 17 Antoine Lubineau
h4. Créer un dépôt
85 17 Antoine Lubineau
86 17 Antoine Lubineau
Il suffit de créer la ligne
87 17 Antoine Lubineau
<pre>
88 17 Antoine Lubineau
repo monrepo
89 17 Antoine Lubineau
</pre>
90 17 Antoine Lubineau
et de préférence d’y ajouter des utilisateurs :)
91 8 Antoine Lubineau
92 1 Antoine Lubineau
h2. git-daemon
93 1 Antoine Lubineau
94 15 Antoine Lubineau
h3. Installation
95 15 Antoine Lubineau
96 15 Antoine Lubineau
Rien à faire, @git-daemon(1)@ vient avec @git(1)@.
97 15 Antoine Lubineau
98 15 Antoine Lubineau
h3. Configuration
99 15 Antoine Lubineau
100 15 Antoine Lubineau
La configuration de @git-daemon@ se fait sous Debian dans @/etc/default/git-daemon@.
101 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@.
102 14 Antoine Lubineau
103 4 Antoine Lubineau
h2. "cgit":http://hjemli.net/git/cgit/
104 4 Antoine Lubineau
105 4 Antoine Lubineau
h3. Installation
106 2 Antoine Lubineau
107 29 Antoine Lubineau
Comme il n’y a pas de paquet Debian, il faut le compiler à la main.
108 1 Antoine Lubineau
<pre>
109 29 Antoine Lubineau
wget http://git.zx2c4.com/cgit/snapshot/cgit-0.9.2.tar.xz
110 29 Antoine Lubineau
tar xf cgit-0.9.2.tar.xz
111 29 Antoine Lubineau
cd cgit-0.9.2
112 26 Antoine Lubineau
make get-git
113 1 Antoine Lubineau
</pre>
114 1 Antoine Lubineau
115 8 Antoine Lubineau
On peut modifier le @Makefile@ en mettant
116 29 Antoine Lubineau
<pre>CGIT_SCRIPT_PATH = /var/www/htdocs/cgit</pre>
117 8 Antoine Lubineau
et
118 29 Antoine Lubineau
<pre>prefix = /var/www/cgit</pre>
119 4 Antoine Lubineau
120 9 Antoine Lubineau
Ensuite :
121 9 Antoine Lubineau
<pre>
122 9 Antoine Lubineau
make
123 1 Antoine Lubineau
make install
124 1 Antoine Lubineau
</pre>
125 9 Antoine Lubineau
126 10 Antoine Lubineau
h3. Configuration de cgit
127 1 Antoine Lubineau
128 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@ :
129 12 Antoine Lubineau
<pre>
130 12 Antoine Lubineau
repo    testing
131 12 Antoine Lubineau
        RW+     =   pipo
132 12 Antoine Lubineau
        R       =   gitweb
133 12 Antoine Lubineau
</pre>
134 10 Antoine Lubineau
135 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 ».
136 13 Antoine Lubineau
137 10 Antoine Lubineau
La configuration de @cgit@ se trouve dans @cgitrc(5)@ :
138 1 Antoine Lubineau
<pre>
139 10 Antoine Lubineau
virtual-root=/
140 10 Antoine Lubineau
project-list=/home/git/projects.list
141 16 Antoine Lubineau
scan-path=~git/repositories/
142 16 Antoine Lubineau
snapshots=tar.gz tar.bz2
143 16 Antoine Lubineau
enable-commit-graph=1
144 16 Antoine Lubineau
enable-tree-linenumbers=1
145 16 Antoine Lubineau
enable-index-links=1
146 16 Antoine Lubineau
enable-log-filecount=1
147 16 Antoine Lubineau
enable-log-linecount=1
148 16 Antoine Lubineau
max-stats=quarter
149 16 Antoine Lubineau
clone-prefix=http://git.tetaneutral.net git://git.tetaneutral.net
150 10 Antoine Lubineau
</pre>
151 10 Antoine Lubineau
152 21 Antoine Lubineau
h3. Configuration d’Apache
153 10 Antoine Lubineau
154 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@ :
155 10 Antoine Lubineau
<pre>
156 6 Antoine Lubineau
usermod -aG git www-data
157 1 Antoine Lubineau
</pre>
158 1 Antoine Lubineau
159 11 Antoine Lubineau
Dans @~git/.gitolite.rc@, changer
160 1 Antoine Lubineau
<pre>
161 1 Antoine Lubineau
$REPO_UMASK = 0077;
162 1 Antoine Lubineau
</pre>
163 1 Antoine Lubineau
en
164 1 Antoine Lubineau
<pre>
165 1 Antoine Lubineau
$REPO_UMASK = 0027;
166 1 Antoine Lubineau
</pre>
167 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).
168 1 Antoine Lubineau
169 10 Antoine Lubineau
À mettre dans un _virtual host_ d’Apache :
170 1 Antoine Lubineau
<pre>
171 29 Antoine Lubineau
        DocumentRoot /var/www/cgit
172 29 Antoine Lubineau
        <Directory /var/www/cgit>
173 29 Antoine Lubineau
                AddHandler cgi-script .cgi
174 10 Antoine Lubineau
                DirectoryIndex cgit.cgi
175 10 Antoine Lubineau
                Options +FollowSymLinks +ExecCGI
176 10 Antoine Lubineau
                AllowOverride None
177 1 Antoine Lubineau
                Order allow,deny
178 10 Antoine Lubineau
                allow from all
179 10 Antoine Lubineau
180 2 Antoine Lubineau
                RewriteEngine On
181 10 Antoine Lubineau
                RewriteBase /
182 10 Antoine Lubineau
                RewriteCond %{REQUEST_FILENAME} !-f
183 10 Antoine Lubineau
                RewriteCond %{REQUEST_FILENAME} !-d
184 10 Antoine Lubineau
                RewriteRule (.*) cgit.cgi/$1
185 10 Antoine Lubineau
                RewriteRule ^cgit.cgi$  cgit.cgi/
186 29 Antoine Lubineau
187 10 Antoine Lubineau
        </Directory>
188 10 Antoine Lubineau
</pre>