====== TP : Gérer son site web avec Git ======

  * Objet : Gérer son site web avec Git
  * Niveau requis : {{tag>avisé}}
  * Commentaires : //Vous gérez un ou plusieurs sites web sur votre serveur. Vous voulez l'administrer avec git pour faciliter les mises-à-jour/patch/etc.//
  * À savoir : [[:doc:systeme:git:git|Utilisation de git]] :-)
  * Suivi : {{tag>}}
    * Création par [[user>captnfab]] 06/03/2014
    * Testé par <...> le <...> FIXME
  * Commentaires sur le forum : [[https://debian-facile.org/topic-8596-wiki-tp-gerer-son-site-web-avec-git-page-1.html | ici]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

**Nota :**

Contributeurs, les FIXME sont là pour vous aider, supprimez-les une fois le problème corrigé ou le champ rempli !

===== Introduction =====

Vous gérez vos projets ou vos documents avec git, et vous vous demandez comment faire pour gérer vos sites web de même?

Une des fonctionnalités de Git que nous allons fortement utiliser est celle de «//branches//». Nous allons mettre en place un système de //hooks//((crochets: scripts exécutés automatiquement lors de certaines opérations effectuées sur un dépôt git)), pour faciliter l'intégration de notre flot de travail.

Nous allons considérer le schéma suivant, assez classique :

  * Une machine « **serveur** »
    * sur laquelle est installé un serveur **ssh** permettant à l'utilisateur //toto// de se connecter
    * sur laquelle est installé un serveur web publiant les données présentent dans ''/srv/monsiteweb/www'' (dossier inscriptible par //toto//)
    * ainsi que les données présentent dans ''/srv/monsiteweb/www-dev'' (dossier inscriptible par //toto//)

  * Une machine « **client** »
    * sur laquelle //toto// développe son site web.

===== Installation =====

Installer **git** sur le **serveur** et le **client** : 
<code root>apt-get install git</code>

===== Mise en place =====

==== Initialisation du dépôt ====

=== Création d'un dépôt nu sur le serveur ===
Sur le **serveur** :

<code user>mkdir -p /srv/monsiteweb/www.git</code>
<code user>mkdir www.git</code>
<code user>git init --bare www.git</code>

=== Configuration des hooks sur le serveur ===

Sur le **serveur** :
<code user>vim /srv/monsiteweb/www.git/hooks/post-update</code>

Le fichier doit contenir le code suivant :
<code bash /srv/monsiteweb/www.git/hooks/post-update>#!/bin/sh
for i in $*
do
  b=$(basename $i)
  if [ "$b" = "prod" ]
  then
    # Remplacer le chemin par celui utilisé par le serveur web pour
    # la version en production
    GIT_WORK_TREE=/srv/monsiteweb/www/ git checkout -f $b
  fi
  if [ "$b" = "dev" ]
  then
    # Remplacer le chemin par celui utilisé par le serveur web pour
    # la version en développement
    GIT_WORK_TREE=/srv/monsiteweb/www-dev/ git checkout -f $b
  fi
done</code>

Le rendre exécutable :
<code user>chmod +x /srv/monsiteweb/www.git/hooks/post-update</code>

<note idée>Si vous utilisez un moteur de blog statique comme [[http://blog.getpelican.com/|pelican]] ou [[http://posativ.org/acrylamid/|acrylamid]], vous pouvez lancer la recompilation du blog depuis ce fichier, juste après le checkout.</note>

=== Clonage du dépôt sur le client ===
Sur le **client** :
<code user>mkdir -p ~/projets/mon-site/</code>
<code user>cd ~/projets/mon-site/</code>
<code user>git clone toto@serveur:/srv/monsiteweb/www.git</code>

==== Création des branches ====
Ces manipulations sont à faire sur **client**:

=== La branche upstream ===
Cette branche est facultative et contient les sources du site web telles que fournies par son développeur.
<code user>cd ~/projets/mon-site/www</code>

  * Rajouter les-dites sources dans le dossier.
<note info>Par exemple:
<code user>wget 'http://download.dokuwiki.org/src/dokuwiki/dokuwiki-oldstable.tgz' -O/tmp/dokuwiki-oldstable.tgz
tar xf /tmp/dokuwiki-oldstable.tgz --strip-components 1</code></note>

  * Indiquer à git de les prendre en compte :
<code user>git add .</code>
<code user>git commit -m 'Version initiale'</code>

  * Renommer la branche en //upstream// :
<code user>git branch -m master upstream</code>

  * Envoyer la branche sur le dépôt distant :
<code user>git push -u origin upstream</code>

=== La branche dev ===
Cette branche est facultative et contient les sources du site web de développement. Un tel site est pratique pour mettre le code en test avant de le passer en production.

  * Créer la branche //dev// basée sur la branche //upstream// :
<code user>git checkout upstream</code>
<code user>git branch dev</code>
<code user>git checkout dev</code>

  * Appliquer les modifications voulues.
<note info>Par exemple :
<code user>rm README VERSION COPYING</code></note>

  * Valider les changements et envoyer le résultat sur le dépôt distant :
<code user>git commit -a -m 'Préparation à la mise en test'</code>
<code user>git push -u origin dev</code>

Le hook de la branche dev devrait alors s'activer automatiquement et placer les sources dans le dossier de dev sur le serveur.

=== La branche prod ===
Cette branche correspond à la version en cours d'utilisation sur le serveur.

  * Créer la branche //prod// basée sur la branche //dev// :
<code user>git checkout dev</code>
<code user>git branch prod</code>
<code user>git checkout prod</code>


  * La branche de test étant satisfaisante (sinon on ne la passerait pas en production), on se contente de la publier.
<code user>git push -u origin prod</code>

Le hook de la branche prod devrait alors s'activer automatiquement et placer les sources dans le dossier de prod sur le serveur.

===== Opérations courantes =====
Comment intégrer les opérations de maintenance courantes avec la structure git définie.

==== Ajout d'une fonctionnalité ====
//Ou correction d'une fonctionnalité indésirable…//

  * Récupérer des versions à jour du dépôt :
<code user>git checkout dev</code>
<code user>git pull</code>
  * Éditer la branche dev
  * Valider vos modifications :
<code user>git commit -a -m 'bug corrigé'</code>
  * Soumettre vos modifications
<code user>git push</code>
  * Lorsque le résultat est convenable, mettre à niveau la branche master
<code user>git checkout master</code>
<code user>git merge dev -m 'intégration de la correction de bug'</code>
  * Serrer les fesses et soumettre le résultat :
<code user>git push</code>

==== Mise à jour depuis upstream ====

  * Récupérer les nouvelles sources dans la branche //upstream//. 
<code user>git checkout upstream</code>
<note info>Par exemple : <code user>git checkout upstream</code>
<code user>rm -r *</code>
<code user>wget 'http://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz' -O/tmp/dokuwiki-stable.tgz</code>
<code user>tar xf /tmp/dokuwiki-stable.tgz --strip-components 1</code>
<code user>git add --all .</code>
<code user>git commit -a -m 'nouvelle version upstream: Binky (2013-12-08)'</code></note>
  * Soumettre le résultat :
<code user>git push</code>
  * Importer les changements dans la branche de dev :
<code user>git checkout dev</code>
<code user>git rebase upstream</code>
<note important>Corriger les erreurs éventuelles de fusion. Par exemple : 
<code user>git rm VERSION</code>
<code user>git rebase --continue</code></note>
  * Puis soumettre la nouvelle version :
<code user>git push --force</code>
  * Fusionner la branche dev opérationnelle depuis la branche prod :
<code user>git checkout prod</code>
<code user>git merge dev -m 'intégration de la nouvelle version upstream'</code>
  * Serrer les fesses et soumettre le résultat :
<code user>git push</code>

===== Références =====

  * http://www.git-scm.com/book/fr
  * http://toroid.org/ams/git-website-howto (en)
  * https://www.kernel.org/pub/software/scm/git/docs/githooks.html (en)