MiseAJourGit » Historique » Version 6
Marc Leygnac, 27/04/2014 09:30
1 | 6 | Marc Leygnac | h1. Utiliser Git pour les mises à jour de Gepi |
---|---|---|---|
2 | 1 | Marc Leygnac | |
3 | Git est un outil pour développeurs avec lequel ils peuvent travailler simultanément sur un même projet. Le fichiers se trouvent sur un dépôt distant, chaque développeur travaille sur une copie locale de ce dépôt, et Git est utilisé pour synchroniser le contenu de ces dépôts. Git permet également de gérer plusieurs versions (appelées branches) du projet. |
||
4 | |||
5 | Le dépôt officiel de Gepi est géré avec Git, et on peut donc utiliser ce dernier pour faire les mises à jour par synchronisation, ce qui est nettement plus rapide que de télécharger et décompresser une archive. Mais pour mettre en place cette solution il faut avoir un accès complet au serveur, ce qui exclut les hébergements mutualisés. De plus il faudra désactiver Gepi le temps de faire les manipulations nécessaires, s'assurer ensuite que tout fonctionne correctement, et donc choisir plutôt une période de vacances pour ces manipulations. |
||
6 | |||
7 | |||
8 | h2. Mise en place sous Linux |
||
9 | |||
10 | On suppose ici que Gepi se trouve dans le dossier @/var/www/gepi@ d'un serveur sous Debian (ou Ubuntu , ou autre distribution dérivée de Debian). |
||
11 | |||
12 | h3. Préparation |
||
13 | |||
14 | * par précaution faire une sauvegarde du dossier @gepi@ et de la base |
||
15 | * couper les connexions à Gepi, y compris d'éventuelles connexions administrateur |
||
16 | * renommer le dossier @gepi@ en @gepi-bak@ |
||
17 | * installer (si ce n'est déjà fait) Git |
||
18 | <pre>apt-get install git</pre> |
||
19 | * cloner le dépôt officiel, pour cela |
||
20 | 4 | Marc Leygnac | se placer dans /var/www et lancer la commande |
21 | 1 | Marc Leygnac | <pre>git clone git://github.com/tbelliard/gepi.git gepi</pre> |
22 | 5 | Marc Leygnac | ce qui va créer un nouveau dossier @gepi@ contenant les fichiers de la vesion en cours de développement (master) de Gepi et un dossier @.git@ utilsé par Git pour les synchronisations avec el dépôt officiel, |
23 | afin que Git ne tienne pas compte des droits des fichiers du dossier @gepi@, ouvrir avec un éditeur de texte le fichier @config@ du dossier @.git@ et dans la section @[core]@ donner au parmètre @filemode@ la valeur @false@ |
||
24 | <pre>filemode = false</pre> |
||
25 | (si cette ligne n'est pas présente l'ajouter), |
||
26 | 4 | Marc Leygnac | ensuite se placer dans ce dossier @gepi@ et créer une branche correspondant à la branche officielle 1.6.4, |
27 | 1 | Marc Leygnac | <pre> |
28 | 4 | Marc Leygnac | cd gepi |
29 | git checkout origin/release-1.6.4 -b release-1.6.4 |
||
30 | </pre> |
||
31 | enfin modifier les droits (wwww-data:www-data est le user:group auquel doivent appartenir les fichiers afin que le serveur Apache puisse les modifier si nécessaire) |
||
32 | <pre> |
||
33 | cd .. |
||
34 | 2 | Marc Leygnac | chmod -R 775 gepi/ |
35 | 1 | Marc Leygnac | chown -R www-data:www-data gepi/ |
36 | </pre> |
||
37 | * déplacer le fichier connect.inc.php de gepi-back/secure vers gepi/secure |
||
38 | * copier les dossiers gepi-back/documents et gepi-back/photos dans gepi |
||
39 | * éventuellement copier également les dossiers plugins de gepi-back/mod_plugins dans gepi |
||
40 | |||
41 | 5 | Marc Leygnac | Les connexions à Gepi peuvent maintenant rétablies. |
42 | 1 | Marc Leygnac | |
43 | 5 | Marc Leygnac | Dans le cas d'une installation ex-nihilo de Gepi la marche à suivre est la même, excepté bien sûr tout ce qui concerne l'ancien dossier de Gepi. |
44 | 3 | Marc Leygnac | |
45 | 1 | Marc Leygnac | h3. Mises à jour |
46 | |||
47 | 5 | Marc Leygnac | Pour mettre à jour Gepi il suffit désormais de se placer dans le dossier @gepi@ et de lancer les commandes |
48 | 3 | Marc Leygnac | <pre> |
49 | git pull origin |
||
50 | chmod -R 775 * |
||
51 | chown -R www-data:www-data * |
||
52 | </pre> |
||
53 | 1 | Marc Leygnac | Cette mise à jour peut-être faite automatiquement en créant un fichier maj_gepi.sh contenant |
54 | <pre> |
||
55 | #!/bin/bash |
||
56 | cd /var/www/gepi |
||
57 | git pull origin |
||
58 | 3 | Marc Leygnac | chmod -R 775 * |
59 | chown -R www-data:www-data * |
||
60 | 1 | Marc Leygnac | </pre> |
61 | qui sera ensuite exécuté régulièrement par "cron":http://debian-handbook.info/browse/fr-FR/stable/sect.task-scheduling-cron-atd.html. |
||
62 | |||
63 | *Attention :* si un plusieurs fichiers du dossier @gepi@ devaient être modifiés, par exemple pour résoudre temporairement un bug, il faut absolument les sauvegarder avant de faire les modifications, et arrêter les mises à jour tant que les fichiers modifiés sont en place. Les mises à jour ne peuvent être reprises qu'après avoir restauré les fichiers modifiés dans leur état avant modification. |
||
64 | |||
65 | Enfin quand une nouvelle branche officielle sera créée il faudra lancer les commandes |
||
66 | <pre> |
||
67 | cd /var/www/gepi |
||
68 | 6 | Marc Leygnac | git checkout origin/release-1.6.x -b release-1.6.x |
69 | 5 | Marc Leygnac | chmod -R 775 * |
70 | chown -R www-data:www-data * |
||
71 | 1 | Marc Leygnac | </pre> |
72 | et se connecter administrateur pour faire la mise à jour de la base. |
||
73 | |||
74 | |||
75 | h2. Mise en place sous Windows |
||
76 | |||
77 | On supposera ici que Gepi est installé avec Xampp (mais il existe bien d'autres possibiltés) et se trouve dans le dossier C:\xampp\htdocs\gepi |
||
78 | |||
79 | h3. Installation de Git |
||
80 | |||
81 | Le téléchargement automatique de la dernière version de Git pour Windows se fait avec |
||
82 | http://git-scm.com/download/win Si le téléchargement ne se déclenche pas on peut trouver l’utilitaire d'installation sur https://code.google.com/p/msysgit/downloads/list , il faut télécharger la dernière version 'preview'. |
||
83 | |||
84 | Pour les mises à jour de Gepi il n'est pas nécessaire d'installer tous les composants : |
||
85 | |||
86 | * Ajouter "Git Bash Here" au menu contextuel n'est pas nécessaire, mais peut être utile : cela permet par un clic-droit sur un dossier de l'ouvrir dans une console avec un interpréteur bash (et donc d'avoir accès à des commandes Unix). Par contre "Git GUI here" n'a d'intérêt que pour les développeurs. |
||
87 | |||
88 | bq. !install_1.png! |
||
89 | |||
90 | * Sélectionner "Git Bash only" est suffisant, les deux autres options encombreraient inutilement la variable PATH. |
||
91 | |||
92 | bq. !install_2.png! |
||
93 | |||
94 | * Choisir OpenSSH pour ne pas encombrer le système. |
||
95 | |||
96 | bq. !Install_3.png! |
||
97 | |||
98 | * "Chekcout as is" signifie : récupérer les fichiers tels qu'ils sont sur le dépôt officiel. Quant aux "commit" cela concerne uniquement les développeurs. |
||
99 | |||
100 | |||
101 | bq. !Install_4.png! |
||
102 | |||
103 | Après installation on peut vérifier que Git est bien disponible en ouvrant une fenêtre DOS (cmd.exe) et lançant la commande |
||
104 | <pre>C:\Program Files (x86)\Git\bin\git.exe</pre> |
||
105 | Git affiche alors un rappel sur sa syntaxe d'appel. |
||
106 | |||
107 | h3. Préparation |
||
108 | |||
109 | * par précaution faire une sauvegarde du dossier @gepi@ et de la base |
||
110 | * couper les connexions à Gepi, y compris d'éventuelles connexions administrateur |
||
111 | * renommer le dossier @gepi@ en @gepi-bak@ |
||
112 | * cloner le dépôt officiel, pour cela |
||
113 | ouvrir un fenêtre DOS, se placer dans C:\xampp\htdocs\gepi et lancer la commande |
||
114 | <pre>"C:\Program Files (x86)\Git\bin\git.exe" clone git://github.com/tbelliard/gepi.git gepi</pre> |
||
115 | ce qui va créer un nouveau dossier @gepi@, |
||
116 | se placer dans ce dossier @gepi@ et créer une branche correspondant à la branche officielle 1.6.4 |
||
117 | <pre>"C:\Program Files (x86)\Git\bin\git.exe" checkout origin/release-1.6.4 -b release-1.6.4</pre> |
||
118 | * déplacer le fichier connect.inc.php de gepi-back/secure vers gepi/secure |
||
119 | * copier les dossiers gepi-back/documents et gepi-back/photos dans gepi |
||
120 | * éventuellement copier également les dossiers plugins de gepi-back/mod_plugins dans gepi |
||
121 | |||
122 | Les connexions à Gepi peuvent maintenant rétablie. Le nouveau dossier @gepi@ contient un sous-dossier @.git@ que Git utilisera pour synchroniser avec le dépôt officiel. |
||
123 | 3 | Marc Leygnac | |
124 | 5 | Marc Leygnac | Dans le cas d'une installation ex-nihilo de Gepi la marche à suivre est la même, excepté bien sûr tout ce qui concerne l'ancien dossier de Gepi. |
125 | 1 | Marc Leygnac | |
126 | h3. Mises à jour |
||
127 | |||
128 | Pour mettre à jour Gepi il suffit désormais de se placer dans le dossier @gepi@ et de lancer la commande |
||
129 | <pre>"C:\Program Files (x86)\Git\bin\git.exe" pull origin</pre> |
||
130 | 4 | Marc Leygnac | Cette mise à jour peut-être faite automatiquement en créant un fichier @maj_gepi.bat@ contenant |
131 | 1 | Marc Leygnac | <pre> |
132 | cd C:\xampp\htdocs\gepi |
||
133 | "C:\Program Files (x86)\Git\bin\git.exe" pull origin |
||
134 | qui sera ensuite exécuté régulièrement avec le planificateur de tâches. |
||
135 | </pre> |
||
136 | |||
137 | *Attention :* si un plusieurs fichiers du dossier @gepi@ devaient être modifiés, par exemple pour résoudre temporairement un bug, il faut absolument les sauvegarder avant de faire les modifications, et arrêter les mises à jour tant que les fichiers modifiés sont en place. Les mises à jour ne peuvent être reprises qu'après avoir restauré les fichiers modifiés dans leur état avant modification. |
||
138 | |||
139 | Enfin quand une nouvelle branche officielle sera créée il faudra lancer les commandes |
||
140 | <pre> |
||
141 | cd C:\xampp\htdocs\gepi |
||
142 | "C:\Program Files (x86)\Git\bin\git.exe" checkout origin/release-1.6.x -b release-1.6.x |
||
143 | </pre> |
||
144 | et se connecter administrateur pour faire la mise à jour de la base. |