Gepi

h1. Utiliser git

Pour proposer une correction sur un problème particulier ou un ajout de fonctionnalité, vous devez vous créer un dépot sur github (https://github.com) en clonant le dépot tbelliard/gepi.git, cloner ce dépot en local, créer une branche, effectuer vos corrections, pousser cette branche sur votre dépot, annoncer sur la liste de diffusion votre correction

h2. Étape 1 _créer son espace de travail_

Les développeurs ne travaillent pas sur le dépot officiel (git://github.com/tbelliard/gepi.git) mais sur une copie personnelle de ce dépot. Si la correction ou la nouvelle fonctionnalité satisfait la dream team (développeurs historiques qui gérent le dépot officiel), ils l'intégrent sur le dépot officiel.

h3. Étape 1.1 _créer un compte github_

Créer un compte sur https://github.com

Créer un couple de clés SSH sur votre ordinateur

Ajouter la clé publique dans votre compte github (https://github.com/settings/ssh)

h3. Étape 1.2 _créer des copies de travail_

Aller sur le dépot officiel (https://github.com/tbelliard/gepi/) et créer une copie (Fork)

Sur votre ordinateur, mettez en place un dépot git local à partir de votre dépot (https://github.com/Regis85/gepi pour moi)

	mkdir ~/git_gepi

cd ~/git_gepi

git clone git@github.com:Regis85/gepi.git

À partir de là, vous pouvez utiliser Gitk et Git Gui ou le terminal pour récupérer les branches de votre dépot.

Pour pouvoir également mettre à jour votre dépot local à partir du dépot officiel, vous devez ajouter celui-ci comme dépot de référence

	cd ~/git_gepi/gepi

git remote

→ origin

git remote add Officiel https://github.com/tbelliard/gepi.git

git remote  -v

→ Officiel	https://github.com/tbelliard/gepi.git (fetch)

→ Officiel	https://github.com/tbelliard/gepi.git (push)

→ origin	git@github.com:Regis85/gepi.git (fetch)

→ origin	git@github.com:Regis85/gepi.git (push)

Vous pouvez ajouter d'autres dépôts que vous souhaitez suivre.

	_Les étapes suivantes sont l'illustration de mes habitudes, ce n'est pas la seule façon de faire et sûrement pas la meilleure mais elle me convient_

h2. Étape 2 _mettre à jour son dépôt_

h3. _avec git gui_

Lancer git gui → Dépôt distant → Récupérer de → All (ou un des dépôts que vous suivez)

Branche → Créer → Branche de suivi

(ou)

Branche → Charger

(puis)

Fusionner → Fusion locale → Branche de suivi → choisir la branche

Choisir au besoin une autre branche locale et la fusionner à celle du dépôt officiel

h3. _dans un terminal_

Se placer dans le répertoire et vérifier les dépôts

	cd git_gepi/gepi

:~/git_gepi/gepi$ git remote

→ Officiel

→ origin

Récupèrer toutes les données du dépôt

	git_gepi/gepi$ git fetch Officiel 

→ remote: Counting objects: 86, done.

→ remote: Compressing objects: 100% (23/23), done.

→ remote: Total 51 (delta 39), reused 40 (delta 28)

→ Unpacking objects: 100% (51/51), done.

~/git_gepi/gepi$ git branch

→ * master

Créer des branches au besoin

	 git_gepi/gepi$ git checkout -b release-1.6.3 origin/release-1.6.3

→ Branch release-1.6.3 set up to track remote branch release-1.6.3 from origin.

→ Switched to a new branch 'release-1.6.3'

git_gepi/gepi$ git branch

→   master

→ * release-1.6.3

ou se placer sur la branche à utiliser

	 git_gepi/gepi$ git checkout release-1.6.3 

→ Switched to branch 'release-1.6.3'

git_gepi/gepi$ git branch

→   master

→ * release-1.6.3

Mettre à jour deouis le dépôt officiel

	 git_gepi/gepi$ git merge Officiel/release-1.6.3

→ Updating 66aeffc..a7f8305

→ Fast-forward

→  gestion/droits_acces.php |   4 

→  lib/share.inc.php        | 115

→  mod_abs2/export_stat.php |   3

→  prepa_conseil/index1.php |  64

→  4 files changed, 130 insertions(+), 56 deletions(-)

git_gepi/gepi$ git status

→  # On branch release-1.6.3

→  # Your branch is ahead of 'origin/release-1.6.3' by 11 commits.

→  #   (use "git push" to publish your local commits)

→  #

→  nothing to commit, working directory clean

Après la mise à jour le dépôt personnel sur github n'est plus à jour.

Pour le mettre à jour

	 git_gepi/gepi$ git push

→  Counting objects: 81, done.

→  Delta compression using up to 2 threads.

→  Compressing objects: 100% (48/48), done.

→  Writing objects: 100% (48/48), 10.61 KiB, done.

→  Total 48 (delta 36), reused 0 (delta 0)

→  To git@github.com:Regis85/gepi.git

→  66aeffc..a7f8305  release-1.6.3 -> release-1.6.3

git_gepi/gepi$ git status

→  # On branch release-1.6.3

→  nothing to commit, working directory clean

...

h1. Utiliser git en ligne de commande

Mettre en place un dépot git local à partir du dépot officiel :

	mkdir ~/git_gepi

cd ~/git_gepi

git clone git://github.com/tbelliard/gepi.git

h2. En vrac...

En vrac, j'avais noté:

git checkout developpement : va te sortir la branche développement dans le répertoire de travail.

git checkout production : va te sortir la branche production dans le répertoire de travail.

git status : permet de savoir quelle branche est chargée dans le répertore de travail.

git commit -m "MESSAGE" chemin/fichier : va commiter en local dans la branche du répertoire de travail...

git push origin production : va envoyer les fichiers commités en local vers le dépot github

git diff developpement joss/developpement : affiche un diff des branches indiquées

git log --name-only joss/developpement : affiche un log des commits avec les fichiers concernés

git fetch all

Ajouter le dépôt de Josselin, afficher dans le dossier courant la branche developpement, récupérer les dernières modifications sur le dépot de Josselin, prendre en compte dans le dépot local les modification commitées par Josselin sur son dépôt :

git remote add joss git@github.com:kigeia/gepi

git checkout developpement

git fetch joss

git merge joss/developpement

git branch -a : lister les branches

git reset --hard [sha_du_commit_avant_merge]

git reset --hard HEAD : Annuler les changements non commités. Reset de la copie de travail. Retour à la version la plus récente de la branche courante.

HEAD est un pointeur vers la branche courante, à son niveau de commit le plus récent.

En supposant que tu as poussé tes commit précédent sur origin/master,

le mieux est encore de faire git merge <branche>, puis quand tu as

fini le merge tu fait git diff origin/master. Si ça convient pas tu

fais git reset --hard origin/master; ou git push sinon.

============================================================

Pour annuler un commit particulier, sans perturber ceux effectués entre temps:

12:05 steph@hpcrob ~/gepi_git_officiel/gepi(release-1.6.1) $ git merge marc/no_stack_overflow

Updating e66cd62..d9ef04c

Fast-forward

 lib/share.inc.php |   15 +++++++++++++--

1 files changed, 13 insertions(+), 2 deletions(-)

12:06 steph@hpcrob ~/gepi_git_officiel/gepi(release-1.6.1) $

git revert d9ef04c58

============================================================