Voir la source de Aide mémoire d'Arthur pour l'utilisation de Git

{{Introduction
|texte=
|index=Informatique:Index
}}
== L'essentiel ==
{{parW|1=
{{fig|Diagramme de flux de git|gitFlowDiagram.svg||10cm}}
}}

== Las variables ==
{{parW|1=
;{{m|<rem…>}} remote
:distant, une base git distante, sur une autre machine
;{{m|<loc…>}} local
:local, une base git locale, sur la machine utilisée
;{{m|<dep…>}} depository
:depository (repository ne sera pas utilisé pour ne pas confondre avec repertoire)
;{{m|<wrk…>}} work
:work, de travail, ce qui correspond en général au répertoire de travail
;{{m|<…Url>}} url
:uniform resource locator, adresse web d'une base git
;{{m|<…Dir>}} {{m|<…Rep>}}  directory
:répertoire physique sur le disque dur.
;{{m|<…ParentDir>}} {{m|<…ParentRep>}} parent directory
:répertoire parent sur le disque dur.
;{{m|<…GitName…>}}
:nom de la base git
}}
{{Ex|
Exemples de <remGitNameUrl> :

 atoross@claumep1:/home/var/git/loco
 file:///home/atoross/dvlp/gitTests/remGitBase 
 https://anomnymous@git.salome-platform.org/gitpub/modules/med.git
}}

== Les différentes espaces de Git ==
{{parW|1=
{{code|lang=text|code=
stash        wrkDir        stgArea        locDep        remDep
}}
}} 
=== stash ===
{{parW|1=L'espace {{m|stash}} ({{mm|stash}}) (cachette) est une espace de stockage temporaire des données qui ne sont pas encore enregistrées (not commited); c'est une sauvegarde de l'espace {{m|staging area}}.
* [http://git-scm.com/book/en/Git-Tools-Stashing it Tools - Stashing]
}}
=== staging area - index ===
{{parW|1=L'espace {{m|staging area}} ({{mm|stgArea}}) est une espace de stockage des données qui ne sont pas encore enregistrées (not commited).
}}

=== working directory ===
{{parW|1=L'espace {{m|working directory}} ({{mm|wrkDir}}) est un répertoire sur un système de fichier qui contient les fichiers de travails. Tous les fichiers et sous répertoires ne sont pas forcément versionnés.
}}
=== local depository ===
{{parW|1=L'espace {{m|local depository}} ({{mm|locDep}}) est une espace de stockage des données versionnées, une base de données git, qui se trouve dans le répertoire nommé {{mm|.git}} qui lui même est dans le répertoire racine de {{m|working directory}}. Ces données sont enregistrées (commited).
}}
=== remote depository ===
{{parW|1=L'espace {{m|remote depository}} ({{mm|remDep}}) est une espace de stockage des données versionnées, une base de données git, qui n'est pas le répertoire nommé {{mm|.git}} de {{m|working directory}}. Il est soit sur le même système de fichier ou sur une autre machines. Ces données sont enregistrées (commited and pushed). Un espace ({{mm|locDep}} peut avoir plusieurs ({{mm|remDep}}.
}}

== Configuration ==
{{parW|1=
*{{mm|git config}}
:*{{mm|--system}}
:: ⟼ {{mm|/etc/gitconfig}}
::Pour tous les utilisateurs 
:*{{mm|--global}}
:: ⟼ {{mm|~/.gitconfig}}
::Pour l'utilsateur courant
:*{{mm|{{cadreG|}}}}
:: ⟼ {{mm|<locGitNameRep>/.git/config}}
::Seuelement pour la base locale (quand on est dans <locGitNameRep>)
}}
=== system ===
==== Certificat auto-certifié ====
{{parW|1=
Solution 1 :
<source lang="bash">
su -
git config --system http.sslVerify false
</source>
Solution 2 :
<source lang="bash">
export GIT_SSL_NO_VERIFY=true 
</source>
}}
=== global ===
==== Identification de l'utilisateur ====
{{parW|1=
<source lang="bash">
git config --global user.name "Arthur TOROSSIAN"
git config --global user.email "arthur.torossian@edf.fr"
</source>
}}
==== Exemple de fichier config ====
{{parW|1=
<source lang="bash">
more ~/.gitconfig
</source>
}}
{{parW|1=
<source lang="ini">
[http]
        sslVerify = false
[user]
        name = Arthur Torossian
        email = arthur.torossian@edf.fr
[credential "https://at.bht.fr"]
        provider = generic
[credential "http://pac-ad-edf.proxy.edf.fr:3131"]
        provider = generic
[credential "https://git.forge.pleiade.edf.fr"]
        provider = generic
[core]
        excludesfile = C:/Users/C07138/.gitignore_global
        ignorecase = true
        attributesfile = C:/Users/C07138/.gitattributes_global
        whitespace = cr-at-eol
        autocrlf = false
        blank-at-eof = false
</source>
}}

==== Las attributs .gitattributes ====
{{parW|1=
{{code|lang=bash|code=
git config --global core.attributesfile ~/.gitattributes_global
}}
Contenu possible :
{{code|lang=text|code=
#* text=auto # see :  autocrlf = false
}}
}}
==== Ignorer les fichiers .gitignore ====
{{parW|1=
Ajouter le ~/.gitignore_global aux fichiers exclus en tapant, {{m|y compris sous WINDOWS}}:
<source lang="bash">
git config --global core.excludesfile ~/.gitignore_global
</source>
Rendre la configuration non sensible à la casse :
<source lang="bash">
git config --global core.ignorecase true
</source>
cette option se retrouve alors dans le fichier {{mm|wrkDir/.git/config}}
Pour un répertoire spécifique, créer ce fichier nommé {{mm|.gitignore}} dans le répertoire à filtrer (en général la racine qui est {{mm|wrkDir}}) en le complétant par :
<source lang="text">
.gitignore
.project
.pydevproject
.settings
noPull
noPush
*chenal3.cfg*
modAtTool

# My generated #
###################
tmp*
gen*
external*
*generated*
*Copie*
*Copy*
*.puml
*PlantUml.png

# Editor generted #
###################
*~
*bak
*back.py

# Compiled source #
###################
*.com
*.class
*.dll
*.exe
*.o
*.so
*.pyc

# Packages #
############
# it's better to unpack these files and commit the raw source
# git has its own built in compression methods
*.7z
*.dmg
*.gz
*.iso
*.jar
*.rar
*.tar
*.zip

# Logs and databases #
######################
*.log

# OS generated files #
######################
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db
</source>
}}
{{Rq|Ne pas laisser d'espace devant les pattern de filtrage.}}

=== La complétion des commandes de git ===
{{parW|1=
Copier le fichier de complétion:
<source lang="bash">
cp /etc/bash_completion.d/git ~/.git-completion.sh
</source>
et ajouter dans ~/.bashrc la ligne suivante :
<source lang="bash">
source ~/.git-completion.sh
</source>
}}
=== Un prompt affichant les branches ===
{{parW|1=
A mettre dans {{mc|.bashrc}} ⟼ [[Exemples de .bashrc]]
}}

=== Les outils : éditeur et fusion et différence  ===
{{parW|1=
<source lang="bash">
git config --global core.editor gedit
git config --global merge.tool tkdiff
</source>
}}
{{parW|1=
{{code|lang=bash|code=
git config --global diff.tool meld
git config --global difftool.meld.path "/usr/bin/meld"
git config --global difftool.prompt false
git config --global merge.tool meld
git config --global mergetool.meld.path "/usr/bin/meld"
git config --global mergetool.prompt false
}}
Utilisation
{{code|lang=bash|code=
git difftool  HEAD^1 comMultiZone/common.py
}}
}}

=== Dimensionner la taille des paquets d'envoi quand le protocole http est utilisé ===
{{parW|1=
SI le massage suivant est ertourné :
<source lang="text">
Expected ok/error, helper said 2004[...]
</source>
<source lang="bash">
git config --global http.postBuffer 209715200
</source>
}}

=== Le fichier bashrc pour git bash sous windows ===
{{parW|1=
Se trouve dans {{mm|<nowiki>C:\Users\<your user name></nowiki>}}. 

Si on exécute la commande {{mm| echo ~}} on obtient par exemple {{dq|/c/Users/Arthur}}
}}

=== Les alias ===
{{parW|1=
Lire d'abord [[Exemples de .bashrc#ref|Exemple de référence]]
{{code|lang=bash|code=
alias gad='git add '
..
}}
{{code|lang=bash|code=
git config --global alias.sw   'checkout'
git config --global alias.ad   'add'
git config --global alias.br   'branch'
git config --global alias.cm   'commit' -m 
git config --global alias.co   'checkout'
git config --global alias.cur  'symbolic-ref --short HEAD'
git config --global alias.lg   'log  --pretty=format:"[%h][%cN]%Cgreen[%s]%Cred[%d]" --date=iso  --graph  --abbrev-commit'
git config --global alias.ltag 'describe --exact-match --abbrev=0'
git config --global alias.pl   'pull'
git config --global alias.pu   'push'
git config --global alias.slg  'log  --pretty=format:"[%h]%Cgreen[%s]%Cred[%d]" --graph  --abbrev-commit'
git config --global alias.st   'status'
git config --global alias.sw   'checkout'
git config --global alias.rv  ' remote -v '
git config --global alias.ra  'remote add '
git config --global alias.me  'merge --no-ff --no-commit'
}}
Dautres alias plus spécifiques
{{code|lang=bash|code=
alias branch-merge-point = !bash -c 'diff --old-line-format=--new-line-format= <(git rev-list --first-parent \"${1:-master}\") <(git rev-list --first-parent \"${2:-HEAD}\") | head -1' -
alias branch-diff = !sh -c \"git diff `git branch-merge-point`..\"
alias branch-log = !sh -c \"git log `git branch-merge-point`..\
}}
{{codeTr|lang=bash|code=
git config -l {{!}}grep alias
alias.le=log --oneline --decorate
alias.filelog=log -u
alias.fl=log -u
alias.dl=!git ll -1
alias.dlc=diff --cached HEAD^
alias.dr=!f() { git diff $1^..$1; }; f
alias.lc=!f() { git ll $1^..$1; }; f
alias.diffr=!f() { git diff $1^..$1; }; f
alias.f=!git ls-files {{!}} grep -i
alias.grep=grep -Ii
alias.gr=grep -Ii
alias.cp=cherry-pick
alias.st=status -s
alias.cl=clone
alias.ci=commit
alias.co=checkout
alias.br=branch
alias.diff=diff --word-diff
alias.dc=diff --cached
alias.r=reset
alias.r1=reset HEAD^
alias.r2=reset HEAD^^
alias.rh=reset --hard
alias.rh1=reset HEAD^ --hard
alias.rh2=reset HEAD^^ --hard 
}}
}}

=== Vérifier la configuration ===
{{parW|1=
<source lang="bash">
git config --list
git config user.name
</source>
}}

== Aide ==
{{parW|1=
<source lang="bash">
git <commande> -h
man git-<commande>
git help <commande>
git --help <commande>
</source>
exemple :
<source lang="bash">
git config -h
man git-config
git help config
git --help config
</source>
}}
== Les commandes les plus utilisées ==
{{not|cp : copier(copy)}}
{{not|mv : déplacer(mv)}}
{{not|rec : enregistrer(record), inscrire juste le nom}}
{{not|unrec : dés-enregistrer(unrecord), effacer le nom}}
=== Désigner une révision - HEAD ===
{{parW|1=
* {{m|HEAD}} désigne la dernière révision, notée N, de la branche pointée par le locRep.
* {{m|HEAD~}} ou {{m|HEAD^}} ou {{m|HEAD~1}} {{m|HEAD^1}} désigne la révision N-1.
* {{m|HEAD~2}} désigne la révision N-2.
* {{m|HEAD^2}} désigne la révision N-2 du deuxième parent dans le cas où on peut avoir plusieurs parents.
* {{m|ORIG_HEAD}} est l'état antérieur de {{m|HEAD}} pour certaines opérations critiques. Il est moins utile maintenant que git a reflog: {{mm|git reflog show}} donne par exemple : 
*: {{code|lang=text|colNb=80|code=
febdfb9 (HEAD -> master, origin/master, origin/HEAD) HEAD@{0}: checkout: moving from at to master
010837a (origin/at, at) HEAD@{1}: checkout: moving from master to at
febdfb9 (HEAD -> master, origin/master, origin/HEAD) HEAD@{2}: commit: save
010837a (origin/at, at) HEAD@{3}: pull: Fast-forward
}}
}}
{{Rq|Les révisions sont aussi appelées des {{dq|commit}}. Par exemple {{m|HEAD^1}} désigne le dernier {{dq|commit}} (last commit). Dans la documention de git les {{dq|commit}} sont noté {{dq|<commit>}}.
}}
{{parW|1=
exemples :
<source lang="bash">
git lg  HEAD~1^2
git lg  origin/master~1
</source>
<source lang="bash">
git log  --pretty=format:"%h"   --graph
</source>
<source lang="text">
*   1bd1d09
|\  
| *   37d48e9
| |\  
| | * edae2b9
| | * 42bb57e
| |/  
|/|   
| * 74dc61f
| * c43c75d
|/  
* eedbf2e
* 0361888
* 87c79ea
</source>
<source lang="bash">
git lg -1 HEAD~1
</source>
<source lang="text">
* eedbf2e
</source>
<source lang="bash">
git lg -1 HEAD^1
</source>
<source lang="text">
* eedbf2e
</source>
<source lang="bash">
git lg -1 HEAD~2
</source>
<source lang="text">
* 0361888
</source>
<source lang="bash">
git lg -1 HEAD^2
</source>
<source lang="text">
37d48e9
</source>
}}

=== S'authentifier aévec mot de passe stocké temporairement ===
{{parW|1=
Pour garder le mot de passe pour 3 heures 
{{code|lang=bash|code=
git config --global credential.helper 'cache --timeout=10800'
}}
Pour garder le mot de passe pour une heure
{{code|lang=bash|code=
git config --global credential.helper 'cache --timeout=3600'
}}
Pour garder le mot de passe pour un certain temps
{{code|lang=bash|code=
git config --global credential.helper cache
}}

Sous windows (pas possible de mettre un timeout):
{{code|lang=bash|code=
git config --global credential.helper wincred
}}
{{cadreR|
Si vous êtes bloqué sous windows, on peut gérer les dientifications en cherchant dans tapant {{dq|Gérer vos informations d'identification}}
}}
}}
{{Rq|1=
Attention dans certain cas par défaut le paramétrage peut être dans {{mm|--system}}.
}}

=== Copier une base locale - clone ===
{{parW|1=
<source lang="bash">
git clone <remGitNameUrl>  <locGitNameRep>
</source>
Cette commande créera la répertoire <GitName>.
}}
=== Pour une base locale existante modifier l'emplacement du répertoire {{dq|.git}} ===
{{parW|1=
Utilisation de {{dq|{{mm|--separate-git-dir}}}}
{{code|lang=bash|code=
git clone <remGitNameRep> <locGitNameRep> \
                 --separate-git-dir=<newPathOfLocGitRep> 
}}
Exemple :
{{code|lang=bash|code=
git clone /c/chenal3/chenal /c/chenal3/newChenal \
                 --separate-git-dir=/c/chenal3/newChenalGitRep
}}
}}

=== Ajouter/Add un fichier au «stgArea»===
{{parW|1=

{{code|lang=bash|code=
git add <filepath>
git add <dirpath>
git add ./rep1/dvlp1File.txt
}}

Seulement les éléments déjà ajoutés:
{{code|lang=bash|code=
git add -u [--] [filepattern ...]
git add -u 
git add -u "*.c" "../*.h"
}}

Tous les éléments:
{{code|lang=bash|code=
git add -A [--] [filepattern ...]
git add -A 
git add -A "*.c" "../*.h"
}}
{{cadreR|Attention {{mmm|git add -A}} supprimera dans stgArea les fichiers qui ne sont plus dans {{mmm|wrkDir}}.}}
{{cadreV|Attention {{mmm|git add -n}} permet de tester sans toucher {{mmm|stgArea}}, très pratique si l'on n'est pas sûr, exemple {{mmm|git add -n -A "../ser*" "../inter*"}}.}}
{{code|lang=text|code=
stash        wrkDir        stgArea    locDep   remDep
                └────rec──────▶│
                   "add" ou "add -u"        

stash        wrkDir        stgArea    locDep   remDep
                └────rec──────▶│
                              some
                               └unrec─▶∅
                   "add -A"
}}
}}
===  Montrer les différences et comparer ===
{{parW|1=

Entre deux tags :
{{code|lang=bash|code=
git diff tag1 tag2
git diff tag1 tag2 -- some/file/name
}}

Pour ne voir que la liste des fichiers qui comportent des différences:
{{code|lang=bash|code=
git diff tag1 tag2 --stat
}}

Pour une différence avec le répertoire courant:
{{code|lang=bash|code=
git diff tagX
git diff tagX -- some/file/name
git diff tagX  --stat
}}

}}
=== Enregistrer/Commiter les fichiers déjà ajoutés dans «locDep» ===
{{parW|1=
{{codeTr|lang=bash|code=
git commit -m <message>
git commit -m "dvlp01-01"
}}
{{code|lang=text|code=
stash        wrkDir        stgArea    locDep   remDep
                │             └unrec─▶∅
                └───────────cp───────────▶<newSha1>
                                          <sha1>
                                           ...
                    "commit -m <message>"        
}}
}}


=== Annuler ===
==== Annuler un ajout d'un fichier au «stgArea» - “unadd” - "reset <path>" ====
{{parW|1=
{{code|lang=bash|code=
git reset <filepath>
git reset HEAD <filepath>
}}
{{dq|wrkDir}} n'est pas impacté.
{{code|lang=text|code=
stash        wrkDir        stgArea    locDep   remDep
                     ∅◀─unrec─┘ 
                         "reset <path>"
}}
}}

==== Annuler/Uncommiter le dernier enregistrement dans « locDep » ====
{{parW|1=
{{codeTr|lang=bash|code=
git reset --soft HEAD^
}}
{{dq|wrkDir}} et {{dq|stgArea}} ne sont pas impactés.
{{code|lang=text|code=
stash        wrkDir        stgArea    locDep   remDep

                                ∅◀─mv─<HEAD>
                                       <HEAD^>
                                        ...

                                  "reset --soft HEAD^"
}}
}}
{{Rq|La commande {{mm|git reset --soft HEAD}} ne fait rien}}

==== Annuler/Uncommits plusieurs enregistrements dans « locDep » ====
{{parW|1=
{{codeTr|lang=bash|code=
git reset --soft HEAD^^^
git reset --soft dba146f
}}
{{dq|wrkDir}} et {{dq|stgArea}} ne sont pas impactés.
{{code|lang=text|code=
stash        wrkDir        stgArea    locDep   remDep

                              ∅◀─mv─ <HEAD>  
                              ∅◀─mv─ <HEAD^>  
                              ∅◀─mv─ <HEAD^^>  
                                     <HEAD^^^>=<Commit>
                                        ...   

                         "reset --soft <Commit>"
}}
}}

==== Annuler/unLocalyModify toutes les modifications dans « wrkDir » ====
{{parW|1=
{{codeTr|lang=bash|code=
git reset --hard
git reset --hard HEAD
}}
{{dq|wrkDir}} et {{dq|stgArea}} sont directement impactés.
{{code|lang=text|code=
stash        wrkDir        stgArea    locDep    remDep
               │     ∅◀─unrec─┘  
               │◀───────────cp────────<HEAD>  
                                       ...   

                    "reset --hard HEAD"
}}
}}
==== Annuler/unLocalyModify les modifications d'un fichier dans « wrkDir »  ====
{{parW|1=
{{codeTr|lang=bash|code=
git checkout HEAD Makefile
}}

{{code|lang=text|code=
stash        wrkDir        stgArea    locDep    remDep
               │     ∅◀─unrec─┘  
               │◀───────────cp────────<HEAD>  
                                       ...   

                    "git checkout HEAD Makefile"
}}
}}
=== Dépôt distant ===
==== Changer le dépôt distant {{dq|{{mm|origin}}}}====
{{parW|1=
{{code|lang=bash|code=
git remote rename origin origin-old
git remote add origin git@gitlab.pleiade.edf.fr:eelCounter/eelCounter.git
git branch --set-upstream-to=origin/master master
}}
}}

==== Connaître l'url de la base distante - remote ====
{{parW|1=
<source lang="bash">
git remote -v
</source>
<source lang="text">
origin	<remGitNameUrl>  (fetch)
origin	<remGitNameUrl>  (push)
</source>
}}

==== Ajouter un dépôt distant - remote add ====
{{parW|1=
{{cadrePar|1=
{{mm|remoteName}} est nom (une variable) correspondant à la base distante 
{{codeTr|lang=bash|code=
git remote add <remoteName> <path>
git remote add <remoteName> <remotePath>
git remote add <remoteName> <localPath>
git remote add <remoteName> <url>
}}
}}
}}
{{parW|1=
{{cadreB|cas distant :}}
{{codeTr|lang=bash|code=
git remote add claumep1 http://claumep1.der.edf.fr/git/P112N_pivot.git
git remote add atorossClaui2v9 ssh://atoross@claui2v9.der.edf.fr/local01/atoross/dvlp/vishnu/github_vishnu.git
}}
{{codeTr|lang=bash|code=
git pull <remoteName> [<remoteBranchName>]
}}
{{codeTr|lang=bash|code=
git pull atorossClaui2v9 zmq
}}
}}
{{parW|1=
{{cadreB|cas local:}}
{{codeTr|lang=bash|code=
git remote add theTrunk /home/C07138/opentelemacTrunk

git remote -v
git branch 

git stash 
git pull theTrunk master

git pull theTrunk master

git branch gouttedo
git branch 
git checkout gouttedo 

git pull theTrunk gouttedo
}}
}}

==== Enlever un dépôt distant - remote rm ====
{{parW|1=
<source lang="bash">
git remote rm claui2v6
</source>
}}
==== Inspecter un dépôt distant - remote -v show ====
{{parW|1=
<source lang="bash">
git remote -v show <remoteName>
</source>
Example :
<source lang="bash">
git remote -v show origin
</source>
}}
=== Merger  ===
==== Merger une branche (locale) dans la branche courante ====
{{parW|1=
{{code|lang=bash|code=
git merge multiZoneDvlp
}}
}}
==== Merger seulement des fichiers d'une branche dans la branche courante ====
{{parW|1=
{{code|lang=bash|code=
git merge --no-ff --no-commit <branch>
git status
git merge --no-ff --no-commit at
git status
}}
* {{mm|--no-ff}} : pas de  fast-forward
* {{mm|--no-commit}} : pas de commit

Vous aurez alors une liste de fichiers automatiquement fusionnés(merged) et d'autres avec des fusions comportant des conflits.

Pour les fichiers auto-fusionnés on peut inspecter le fusion avec la commande :
{{code|lang=bash|code=
git diff --cached <filepath>
}}

Pour fusions avec conflit il faut les éditer et faire le choix soi-même, sinon on peut choisir entre la branche et la branche courante.

Choix de la branche courante :
{{code|lang=bash|code=
git checkout HEAD <filepath>
}}

Choix de la branche à fusionner :
{{code|lang=bash|code=
git checkout <branch>  <filepath>
}}
}}

==== Merger une branche distante - branch merge ====
{{parW|1=
{{code|lang=bash|code=
git checkout master
git branch -a -v
git merge remotes/origin/BOU/addStudyExamples
}}
}}

==== gérer les conflits lors des merges/fusions ====
{{parW|1=
Le cas imprévu :
{{code|lang=bash|code=
git pull lex256 master
git checkout --theirs facture/facture.ods
git add -facture/facture.ods
git pull lex256
}}
Le cas prévisible :
{{code|lang=bash|code=
git pull -s ours
git pull -X theirs
}}

}}

=== Branches ===
==== Supprimer une branche ====
{{parW|1=
exemple :
{{code|lang=bash|code=
git branch -d sph_rpa-1.0.0.0
git branch -D sph_rpa-1.0.0.0 # sans confirmation
}}
}}
==== Lister les branches - fetch, branch ====
{{parW|1=
exemple :
{{code|lang=bash|code=
git fetch -p
git branch -a -v
}}
}}
==== Récupérer / changer une branche distante - fetch, checkout --track ====
{{parW|1=
<source lang="bash">
git fetch <remoteName>
git checkout --track <remoteName>/<remoteBrancheName> 
</source>
* checkout : http://git-scm.com/docs/git-checkout
}}
{{parW|1=
exemple :
{{code|lang=bash|code=
git fetch -p
git branch -a -v
git checkout remotes/origin/BOU/addStudyExamples
}}
}}
==== Créer une nouvelle branche - branch ====
{{parW|1=
<source lang="bash">
git branch <newBranchName> <refBranchName> 
git branch v0.1 master
git checkout v0.1
git push origin at/v0.1
</source>
}}

==== Partager une nouvelle branche - push <remoteName> <xx>/<topic> ====
{{parW|1=
<source lang="bash">
git branch <xx>/<topic>
git co <xx>/<topic> 
git branch
...
git push <remoteName> <xx>/<topic>
</source>
}}
==== Renomer une branche - git branch -m <new-name> ====
===== Rename your local branch =====
{{parW|1=
If you are on the branch you want to rename:
{{code|lang=bash|code=
git branch -m new-name
}}
If you are on a different branch:
{{code|lang=bash|code=
git branch -m old-name new-name
}}
}}
=====  Delete the old-name remote branch and push the new-name local branch =====
{{parW|1=
{{code|lang=bash|code=
git push origin :old-name new-name
}}
}}
=====  Reset the upstream branch for the new-name local branch =====
{{parW|1=
{{code|lang=bash|code=
git push origin -u new-name
}}
}}

=== Tag ===
==== Taguer une version d'application (pushable) ====
{{parW|1=
{{codeTr|lang=bash|code=
git tag -a  cloggingGridModel_rpa-1.0.0 -m "cloggingGridModel version rpa-1.0.0"
}}
}}
==== Le dernier commit - tag -s -a v0.1 -m "FPL 0.1" ====
{{parW|1=
Préparer une clé gpg
{{codeTr|lang=bash|code=
gpg --gen-key
gpg --list-keys
}}
{{code|lang=text|code=
Real name: Arthur Torossian
Email address: arthur.torossian@edf.fr
You selected this USER-ID:
    "Arthur Torossian <arthur.torossian@edf.fr>"
}}

{{codeTr|lang=bash|code=
/home/atoross/.gnupg/pubring.gpg
--------------------------------
pub   3072D/DDDFB557 2013-07-05
uid                  Arthur Torossian <arthur.torossian@edf.fr>
sub   3072g/999BED15 2013-07-05
}}

Il faut créer de tag avec annotation sinon le tag est {{m|lightweight}} dans ce cas c'est juste un pointeur sur le nœud du commit.
{{codeTr|lang=bash|code=
git tag -s -a v0.1 -m "FPL 0.1"
git tag -v v0.1
git show v0.1
}}

L'option {{m|{{mm|-s}}}} permet de signer avec le mail comme clé.
}}

==== Un ancien commit - tag -s -a v0.1 -m "FPL 0.1" 979e98c  ==== 
{{parW|1=
{{codeTr|lang=bash|code=
git tag -s -a "ciclope.py_x5-1.2.0.1" -m "ciclope.py version x5-1.2.0.1" 979e98c
}}
}}

==== Lister les tags sans notations (lightweight tags, annotated tags)====
{{parW|1=
{{codeTr|lang=bash|code=
git for-each-ref refs/tags/ --format '%(objecttype) %(refname:short)' |     while read ty name; do [ $ty = commit ] && echo $name; done
}}
}}

==== Un ancien commit - tag -s -a v0.1 9fceb02 ====
{{parW|1=
<source lang="bash">
git tag -s -a v0.1 9fceb02
</source>
}}
==== Partager les tags - push origin v0.1 ====
{{parW|1=
<source lang="bash">
git push origin v0.1
</source>
ou
<source lang="bash">
git push origin --tags
</source>
}}
==== Supprimer un tag local ====
{{parW|1=
{{code|lang=bash|code=
git tag -d alpha-3.0.0.0
}}
}}
==== Supprimer un tag distant ====
{{parW|1=
{{code|lang=bash|code=
git push --delete origin alpha-3.0.0.0 
}}
}}

=== Chercher (find) un mot/expression dans un fichier dans toutes les versions ===
{{parW|1=
{{code|lang=bash|code=
git rev-list --all | xargs git grep objToFile  | grep serafinViewer.py
}}
}}
=== Supprimer ===
==== Supprimer un répertoire - rm -r  fuelCell ====
{{parW|1=
<source lang="bash">
git rm -r  fuelCell
git rm -r lightModel   airportsTraffic
</source>
}}
==== Supprimer un répertoire / fichier dans toute l'historique - git filter-branch -f --tree-filter ====
{{parW|1=
{{code|lang=bash|code=
git filter-branch -f --tree-filter "rm -rf  ./donnees/studyExamples  " --prune-empty -- --all
git push --force
}}
}}

=== Sous base ou module ===
==== Organisation ====
{{parW|1=
Pour l'instant il n'y pas moyen d'ajouter plusieurs dépôts pour un sous module. Dans ce cas il vaut mieux ajouter un dépôt local avec un chemin relatif (exemple : {{mm|../modAtTool}}) et ainsi on pourra gérer les dépôts distants depuis la base locale.
}}
==== Ajouter un sous module - une autre base git dans un sous répertoire ====
{{parW|1=
{{code|lang=bash|code=
git submodule add  https://git.forge.pleiade.edf.fr/git/verona.git modAtTool
}}
Il faut tout de suite configurer la liaison avec une branche par exemple ici {{mm|ciclope}}. Ainsi chaque utilisateur du
module a sa propre version.
{{code|lang=bash|code=
git config -f .gitmodules submodule.modAtTool.branch ciclope
}}
}}
==== Configurer la branche du sous module ====
{{parW|1=
{{code|lang=bash|code=
git config -f .gitmodules submodule.modAtTool.branch ciclope
more .gitmodules 
}}
{{code|lang=text|code=
[submodule "modAtTool"]
	path = modAtTool
	url = https://git.forge.pleiade.edf.fr/git/verona.git
	branch = ciclope
}}
}}
==== Récuprer un sous module - puller un sous module ====
{{parW|1=
La première fois :
{{code|lang=bash|code=
git submodule update --init --recursive
}}
Après on peut utiliser la commande {{mm|pull}} lui-même :
{{code|lang=bash|code=
git pull --recurse-submodules
}}
}}
==== Changer l'url du sous module ====
{{parW|1=
{{code|lang=bash|code=
git config --file=.gitmodules submodule.modAtTool.url ../modAtTool
git config --file=.gitmodules submodule.modAtTool.branch chenal3
git submodule sync
git submodule update --init --recursive --remote
}}
}}
==== Renommer un sous module ====
{{parW|1=
{{code|lang=bash|code=
git mv modAtTool/ modExtTool
gcm "rename extern tool"
}}
}}
==== Supprimer un sous module ====
{{parW|1=
{{code|lang=bash|code=
git rm modExtTool
gcm "delete extern tool"
}}
}}

==== Cloner une base avec les sous modules ====
{{parW|1=
Pour une version {{M|≥ 2.13}} :
{{code|lang=bash|code=
git clone --recurse-submodules  https://...myBase.git myBase
}}
}}
==== Voir l'historique - git-log ====
{{parW|1=
La doc en ligne : https://git-scm.com/docs/git-log
{{code|lang=bash|code=
# court
git log --pretty=format:"%h %cd %Cgreen%s %Cred%d" --graph  --abbrev-commit  --date="format:%Y/%m/%d %Hh%M"
# long
$git log --pretty=format:"%h %cd %cn %Cgreen%s %Cred%d" --graph  --abbrev-commit --date="format:%Y/%m/%d %Hh%M"
}}
}}

== Comment s'organiser ==
{{parW|1=
{{fig|le graph|gitCycleGtaph.png}}
}}
=== Créer une nouvelle base ===
{{parW|1=
{{codeTr|lang=bash|code=
cd <locGitBaseRep>
git init
touch README
git add README
git commit -m "init"
git branch
}}
}}
=== Exporter ou archiver hors base - archive ===
{{parW|1=
<source lang="bash">
git archive --format=tar HEAD  ./pivotLanguage/ | gzip > test.tar.gz
</source>
}}

=== Créer un dépôt commun ===
{{parW|1=
{{id|distantGit}}Sur le serveur distant:
{{codeTr|lang=bash|code=
mkdir <remGitBaseRep>
cd <remGitBaseRep>
git init --bare
git update-server-info
cd ..
chown -R www-data:atoross <remGitBaseRep>
}}
L'option {{mm|--bare}} évite d'avoir les fichiers locaux de travail.
}}
{{parW|1=
Sur l'une des machines de travail ou  base de travail:
{{codeTr|lang=bash|code=
git clone https://claumep1.der.edf.fr/git/hydro myHydro
git br
}}
La commande {{mm|git br}} ne renvoie aucune branche. Il faut au minimum {{m|ajouter}}({{mm|add}}) un fichier et enregistrer l'ajout ({{mm|commit}}) afin que la branche par défaut {{m|{{mm|master}}}} apparaisse :
{{codeTr|lang=bash|code=
git add conv.py
git cm -m  "test python file reading med file" conv.py
git br
}}
Cette fois-ci nous avons bien la branche {{m|{{mm|master}}}} :
{{codeTr|lang=text|code=
* master
}}
}}
{{Rq|Je ne sais toujours pas pourquoi il faut ajouter absolument un fichier pour que la branche {{m|{{mm|master}}}} puisse exister localement !}}
{{cadrePar|1={{parW|1=
{{cadreR|Attention tout n'est pas fini}}

Si on utilise {{mm|https/http}}, pour pusher il faut ajouter son login dans {{mm|.git/config}} sinon le push ne passe pas ! 
{{code|lang=text|code=
[remote "origin"]
	url = https://atoross@at.bht.fr/git/atTools.git
}}
Finallement on peut pusher :
{{codeTr|lang=bash|code=
git push --set-upstream  origin  master
}}
Pour pouvoir {{dq|pusher}} et {{dq|puller}} il faut également ajouter au moins un fichier :
{{codeTr|lang=bash|code=
git add readme.txt
gcm "init"
git push
}}
}}
}}

=== Le rôle de l'intégrateur ===
{{parW|1=
<source lang="bash">
cd integratorLocGitBase/
evim intFile.txt
git add intFile.txt
git cm -m "int-01"
git lg origin/master
git push
git lg origin/master
git add intFile.txt
git cm -m "int-02"
git push
git lg origin/master
git fetch
git co --track origin/ar/topic-u2-01 
git co master
git branch 
git merge ar/topic-u2-01 
#git merge --log --no-ff ar/topic-u2-01 
git push 
git co ar/topic-u2-01 
git pull
more dvlp2File.txt 
git co master
git merge --log --no-ff ar/topic-u2-01 
git push
git config user.name "Integrator"
git config --list
git status
more intFile.txt 
git add intFile.txt
git commit -m "int-03"
git push
</source>
<source lang="bash">
git lg origin/master
git remote show origin
git lg
git st
git add intFile.txt
git cm -m "int-04"
git push
git lg
git add intFile.txt
git cm -m "int-05"
git push
git lg
git fetch origin
git co --track origin/at/topic-u1-01 
git br
git status
git br
git sw master
git br
git merge --log --no-ff at/topic-u1-01 
git status
git push
git slg
</source>
}}
=== Rôle de l'utilisateur 1 ===
{{parW|1=
<source lang="bash">
cd dvlp1GitBase/
git lg  origin/master
git pull
branch at/topic-u1-01
git sw at/topic-u1-01 
git branch
git add dvlp1File.txt
git status
git cm -m "dvlp01-01"
git lg
branch
push origin at/topic-u1-01 
git co master
</source>
}}
=== Rôle de l'utilisateur 2 ===
{{parW|1=
{{codeTr|lang=bash|code=
git clone   file:///home/atoross/dvlp/gitTests/remGitBase dvlp2GitBase
cd dvlp2GitBase/
git br ar/topicu2-01
git sw ar/topicu2-01 
git br
git config user.name "Arturo Torossiani"
git pull
git lg
git branch ar/topic-u2-01
git branch
git checkout ar/topic-u2-01 
git branch
git cm -am "dvlp02-01"
git add dvlp2File.txt
git cm -am "dvlp02-01"
git push origin ar/topic-u2-01 
git branch
git cm -am "dvlp02-02"
git push origin ar/topic-u2-01
git lg
more dvlp2File.txt 
git slg
}}
}}
==== Créer un patch ====
{{parW|1=
;-<n>
:Prepare patches from the topmost <n> commits.
{{codeTr|lang=bash|code=
git format-patch master -1
}}
[https://git-scm.com/docs/git-format-patch]
}}

== git-svn ==
{{parW|1=
* [[git-svn]]
}}
== Mes bases Git ==
{{parW|1=
* [[Mes bases Git]]
}}

== Git servi par apache ==
==== Créer une base sans les fichiers locaux - Create a bare repository ====
{{parW|1=
;bare
: nue, sans la partie de travail
<source lang="bash">
cd <remGitNameRep>
git init --bare
git update-server-info
</source>
}}
{{parW|1=
ou à partir d'une base existante

<source lang="bash">
cd <remGitNameParentRep>
git clone --bare <remGitNameUrl> <GitName>.git
git update-server-info
</source>
}}

==== Configurer apache ====
{{parW|1=
* source
*:  http://blog.freelan.org/2011/09/02/installation-dun-serveur-git-avec-apache-sous-linux/
 
on peut ajouter un fichier {{mm|git}} :
{{code|lang=apache|code=
################################################################################
# git
################################################################################
Alias /git/ "/local01/www/arth/git/"
<Location /git>
    DAV on
    Options -Indexes

    <RequireAll>
    Require all granted
    SSLRequireSSL

    AuthType Basic
    AuthName "Git"
    AuthBasicProvider file
    AuthUserFile "/etc/apache2/passwd/passwords_admin"
    <RequireAll>
        Require valid-user
    </RequireAll>
    </RequireAll>
</Location>
}}
{{code|lang=bash|code=
a2ensite git
a2enmod dav
a2enmod dav_fs
/etc/init.d/apache2 restart
}}
{{cadreR|
Pour terminer il faut lire [[#distantGit|Créer une base commune distante]]
}}
}}
== Problèmes rencontrés ==
=== Manque de mémoire ===
{{parW|1=
{{code|lang=text|code=
remote: Counting objects: 11191, done.
remote: warning: suboptimal pack - out of memory
remote: fatal: Out of memory, malloc failed (tried to allocate 348936731 bytes)
remote: aborting due to possible repository corruption on the remote side.
fatal: protocol error: bad pack header
}}
Résolution : ?
}}
== Liens ==
=== Rsync avec git bash sous windows ===
{{parW|1=
* Voir [[Rsync#MSYS2|RSync]]
}}
=== Autres ===
{{parW|1=
* Les commandes GIT que vous devez absolument connaître !
*: https://www.hostinger.fr/tutoriels/commandes-git/
* git-cheatsheet
*: http://ndpsoftware.com/git-cheatsheet.html
* svn basic commands to git commands 
*: http://aliceinfo.cern.ch/Offline/node/2912/
* La dernière version de mon .bash-scm est disponible sur le dépot Git suivant:
*: {{m|{{mm|$ git clone http://repo.or.cz/r/git-scripts.git }} }}
* Enfin, le dépôt sima utilisé pour la démo ainsi que le script de la démo sont récupérable ici si vous voulez expérimenter.
*: {{m|{{mm|$ git clone git://cln46mr/home/git/sima }} }}
* Main Web Site - Site officiel
*: http://git-scm.com/
* commandes
*: http://git-scm.com/book/commands 
* Référence rapide 
*: http://gitref.org/index.html
* Référence 
*: http://git-scm.com/docs
* Community Book
*: http://book.git-scm.com
*: http://git-scm.com/book
* Livre Pro Git - Scott Chacon - Apress
*: http://progit.org
* Tutoriel officiel 
*: http://schacon.github.com/git/gittutorial.html
* Autres tutoriels
*: https://www.atlassian.com/git/workflows
* Manuel officiel 
*: http://schacon.github.com/git/user-manual.html
* Pour les scientifiques http://eagain.net/articles/git-for-computer-scientists/
* Les  commandes http://schacon.github.com/git/everyday.html
* 8 ways to share your git repository
*: http://www.jedi.be/blog/2009/05/06/8-ways-to-share-your-git-repository/
* Setting up GIT with Apache Smart HTTP/S and LDAP 
*: http://loutilities.wordpress.com/2011/08/12/setting-up-git-with-apache-smart-https-and-ldap/
* Topic branches
*: https://github.com/dchelimsky/rspec/wiki/Topic-Branches
* A successful Git branching model 
*: http://nvie.com/posts/a-successful-git-branching-model/
* Mercurial for Git users
*: [http://mercurial.selenic.com/wiki/GitConcepts mercurial.selenic.com]
}}
=== Clients ===
{{parW|1=
* gitk
*: le projet : http://gitk.sourceforge.net/
*: la doc : http://git-scm.com/docs/gitk
* Smart  Git (smartgit)
*:http://www.syntevo.com/smartgithg/index.html
}}
=== Serveur web ===
{{parW|1=
* How To Install A Public Git Repository On A Debian Server
*: https://www.howtoforge.com/how-to-install-a-public-git-repository-on-a-debian-server
* How to setup Git server on Linux Container in Debian
*: http://unix.stackexchange.com/questions/85929/how-to-setup-git-server-on-linux-container-in-debian
}}