====== Git ======
===== Installation =====
L'installation dépend du système d'exploitation.\\ 
Par exemple sous debian:
<code>
apt-get install git
</code>
===== Dépendances =====
Avant de commencer il faut savoir que git se base sur ssh, le serveur client qui souhaitera communiquer avec le dépôt devra partager sa clef ssh publique.
===== Configuration =====
Se placer sur le serveur/poste/répertoire qui hébergera de dépôt git et ne servira qu'à ça, les sources de ce serveur/répertoire ne seront pas éditées.\\ 
Créer et se déplacer dans le répertoire souhaité, exemple :
<code>
cd /home/jonathan/
mkdir depot.git
cd depot.git
</code>
Initialiser le dépt grâce à la commande suivante :
<code>git init --bare</code>
L'option "--bare" signifie que ce ne sera pas un répertoire de travail, contrairement à une initialisation classique que l'on verra plus loin.
\\ 
Se placer sur le serveur/poste/répertoire de travail, d'où le code sera édité.\\ 
Créer et se déplacer dans le répertoire souhaité, exemple :
<code>
cd /home/jonathan/
mkdir remoteserver
cd remoteserver
</code>
Initialiser le répertoire de travail :
<code>
git init
</code>
Pour éviter d'avoir les messages d'alerte, configurer les coordonnées maintenant :
<code>
git config user.email "jonathan@localhost"
git config user.name "jonathan"
</code>
Définir ce répertoire comme clone du dépôt :
<code>
git clone jonathan@remoteserver:'depot.git'
</code>

Le fichier de configuration du répertoire de travail se trouve alors à l'emplacement suivant:
<code>
cat .git/config
[core]
	repositoryformatversion = 0
	filemode = true
	bare = false
	logallrefupdates = true
[user]
	email = jonathan@localhost
	name = jonathan
[remote "origin"]
	url = jonathan@raspiplop:depot.git
	fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
	remote = origin
	merge = refs/heads/master
</code>
Le serveur/poste/répertoire est prêt à être exploité.
===== Utilisation =====

Ajouter un premier fichier, par exemple :
<code>
mkdir monsiteweb
cd monsiteweb
echo "User-agent: *
Disallow: /" > robot.txt
</code>
Ajouter ce répertoire et son contenu comme objets à prendre en compte :
<code>
git add monsiteweb
</code>
Effectuer le premier commit :
<code>
git commit -m "Initial commit : add monsiteweb/robot.txt"
</code>
L'option "-m" permet d'écrire un commentaire, celui ci sera demandé s'il n'est pas précisé, autant ne pas l'oublier.\\ 
Enfin, pousser les modifications vers le dépôt :
<code>
git push origin master
</code>
===== Trucs =====
==== Hooks : Post-Upload ====
Il est possible de préciser au dépôt git d'effectuer des actions après un commit, par exemple pour mettre à jour un site web.\\ 
L'exemple ci-dessous définit le répertoire "/var/www/" comme répertoire de travail :
<code>
sudo git clone /home/jonathan/depot.git /var/www
</code>
Les commandes souhaitées se placent alors dans le fichier suivant :
<code>
cat depot.git/hooks/post-upload
#!/bin/bash
#

##
# Auteur: Jonathan Demmerlé
# Le    : 06/02/2016
##

echo " - mise en production - "

cd /var/www
unset GIT_DIR
sudo git pull origin master

sudo chown -R www-data: /var/www/*
</code>
==== Info : Exclude ====
Il est possible de ne pas prendre en compte des fichiers définis, par exemple, les fichiers temporaires ou de travail de certains logiciels :
<code>
cat .git/info/exclude
# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]

git ls-files --others --exclude-from=.git/info/exclude
*~
</code>