Gepi

h1. Utiliser Git pour les mises à jour de Gepi (@page en construction@)

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.

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.

h2. Mise en place sous Linux

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).

h3. Préparation

* par précaution faire une sauvegarde du dossier @gepi@ et de la base

* couper les connexions à Gepi, y compris d'éventuelles connexions administrateur

* renommer le dossier @gepi@ en @gepi-bak@

* installer (si ce n'est déjà fait) Git

<pre>apt-get install git</pre>

* cloner le dépôt officiel, pour cela

se placer dans /var/www et lancer les commandes

<pre>git clone git://github.com/tbelliard/gepi.git gepi</pre>

ce qui va créer un nouveau dossier @gepi@, puis

<pre>

chmod -R 775 gepi/

chown -R www-data:www-data gepi/

</pre>

pour 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)

Ensuite se placer dans le dossier @gepi@ et créer une branche correspondant à la branche officielle 1.6.4 (le paramètre @-f@ est nécessaire afin que Git ne considère pas les changements de droits et propriétaire des fichiers comme des modifications)

<pre>

cd gepi

git checkout -f origin/release-1.6.4 -b release-1.6.4

</pre>

* déplacer le fichier connect.inc.php de gepi-back/secure vers gepi/secure

* copier les dossiers gepi-back/documents et gepi-back/photos dans gepi

* éventuellement copier également les dossiers plugins de gepi-back/mod_plugins dans gepi

Les connexions à Gepi peuvent maintenant rétablies. Le nouveau dossier @gepi@ contient un sous-dossier @.git@ que Git utilisera pour synchroniser avec le dépôt officiel.

Dans le cas d'une installation ex-nihilo de Gepi seuls l'installation de Git et le clonage du dépôt officiel sont nécessaires.

h3. Mises à jour

Pour mettre à jour Gepi il suffit désormais de se placer dans le dossier @gepi@ et de lancer la commande

<pre>

git pull origin

chmod -R 775 *

chown -R www-data:www-data *

</pre>

Cette mise à jour peut-être faite automatiquement en créant un fichier maj_gepi.sh contenant

<pre>

#!/bin/bash

cd /var/www/gepi

git pull origin

chmod -R 775 *

chown -R www-data:www-data *

</pre>

qui sera ensuite exécuté régulièrement par "cron":http://debian-handbook.info/browse/fr-FR/stable/sect.task-scheduling-cron-atd.html.

*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.

Enfin quand une nouvelle branche officielle sera créée il faudra lancer les commandes

<pre>

cd /var/www/gepi

git checkout -f origin/release-1.6.x -b release-1.6.x

</pre>

et se connecter administrateur pour faire la mise à jour de la base.

h2. Mise en place sous Windows

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

h3. Installation de Git

Le téléchargement automatique de la dernière version de Git pour Windows se fait avec 

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'.

Pour les mises à jour de Gepi il n'est pas nécessaire d'installer tous les composants :

* 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.

bq. !install_1.png!

* Sélectionner "Git Bash only" est suffisant, les deux autres options encombreraient inutilement la variable PATH.

bq. !install_2.png!

* Choisir OpenSSH pour ne pas encombrer le système.

bq. !Install_3.png!

* "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.

bq. !Install_4.png!

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

<pre>C:\Program Files (x86)\Git\bin\git.exe</pre>

Git affiche alors un rappel sur sa syntaxe d'appel.

h3. Préparation

* par précaution faire une sauvegarde du dossier @gepi@ et de la base

* couper les connexions à Gepi, y compris d'éventuelles connexions administrateur

* renommer le dossier @gepi@ en @gepi-bak@

* cloner le dépôt officiel, pour cela

ouvrir un fenêtre DOS, se placer dans C:\xampp\htdocs\gepi et lancer la commande

<pre>"C:\Program Files (x86)\Git\bin\git.exe" clone git://github.com/tbelliard/gepi.git gepi</pre>

ce qui va créer un nouveau dossier @gepi@

se placer dans ce dossier @gepi@ et créer une branche correspondant à la branche officielle 1.6.4

<pre>"C:\Program Files (x86)\Git\bin\git.exe" checkout origin/release-1.6.4 -b release-1.6.4</pre>

* déplacer le fichier connect.inc.php de gepi-back/secure vers gepi/secure

* copier les dossiers gepi-back/documents et gepi-back/photos dans gepi

* éventuellement copier également les dossiers plugins de gepi-back/mod_plugins dans gepi

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.

Dans le cas d'une installation ex-nihilo de Gepi seuls l'installation de Git et le clonage du dépôt officiel sont nécessaires.

h3. Mises à jour

Pour mettre à jour Gepi il suffit désormais de se placer dans le dossier @gepi@ et de lancer la commande

<pre>"C:\Program Files (x86)\Git\bin\git.exe" pull origin</pre>

Cette mise à jour peut-être faite automatiquement en créant un fichier maj_gepi.batr contenant

<pre>

cd C:\xampp\htdocs\gepi

"C:\Program Files (x86)\Git\bin\git.exe" pull origin

qui sera ensuite exécuté régulièrement avec le planificateur de tâches.

</pre>

*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.

Enfin quand une nouvelle branche officielle sera créée il faudra lancer les commandes

<pre>

cd C:\xampp\htdocs\gepi

"C:\Program Files (x86)\Git\bin\git.exe" checkout origin/release-1.6.x -b release-1.6.x

</pre>

et se connecter administrateur pour faire la mise à jour de la base.