Projet

Général

Profil

Git » Historique » Révision 11

Révision 10 (Régis Bouguin, 18/06/2013 19:37) → Révision 11/13 (Régis Bouguin, 18/06/2013 22:06)

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 
 ============================================================