Aide-mémoire Git : configuration, signature GPG, branches et annulations
Commandes Git courantes : configuration, signature GPG, historique, reset/revert, branches, tags, outils de merge et cache GPG sous Windows.
Aide-mémoire Git : configuration initiale, signature GPG, historique, annulation de commits, branches, tags, outils de diff/merge et gestion du cache GPG sous Windows.
Configuration initiale
git --version
git config --global user.name "app_user"
git config --global user.email "user@example.com"
git config --global branch.autosetuprebase always
git config --global color.ui true
git config --global color.status auto
git config --global color.branch auto
git config --global core.editor vim
git config --global merge.tool vimdiff
git config --list
Stockage des identifiants en clair (à éviter sur un poste partagé) :
git config --global credential.helper store
Sous Windows, pour forcer le stockage des identifiants via DPAPI puis vérifier :
git config --global credential.credentialStore dpapi
git config --global --get credential.credentialStore
Pour retrouver l'origine d'un doublon de configuration d'identifiants :
git config --list | Select-String "user\.|credential\."
git config --global --list | Select-String "credential\.azrepos.*username"
git config --local --list | Select-String "credential\.azrepos.*username"
Signature GPG des commits et des tags
gpg --list-secret-keys --keyid-format LONG
git config --global gpg.program "c:/Program Files (x86)/GnuPG/bin/gpg.exe"
git config --global user.signingkey "<KEY_ID>"
git config --global commit.gpgsign true
git config --global tag.gpgsign true
# voir l'origine des paramètres
git config --list --show-origin
Signature manuelle :
git commit -S -m "message"
git tag -s v0.0.1 -m "signed"
Historique (log)
git log --oneline --graph --decorate --all --color
git log --pretty=oneline
git log --stat
git log --pretty=format:"%h %s" --graph
git log --merges --graph --oneline --decorate
git show <commit-hash>
git log -S "texte_recherché" # trouver le commit qui introduit/supprime une chaîne
Version plus lisible et alias :
git log --graph --pretty=format:'%C(yellow)%h%C(reset) - %C(cyan)%an%C(reset) %Cgreen(%cr)%C(reset) %s %C(auto)%d%C(reset)' --all
git config --global alias.tree "log --graph --decorate --all --pretty=format:'%C(yellow)%h%C(reset) %Cblue%an%C(reset) %Cgreen%ad%C(reset) %s %C(auto)%d%C(reset)' --date=format:'%Y-%m-%d %H:%M:%S'"
Dépôt distant
git remote -v
git remote add origin https://git.example.com/org/repo.git
git remote set-url origin https://git.example.com/org/repo.git
git push -u origin master
git push --set-upstream origin master
Synchroniser avec le distant et annuler des modifications
Attention : git reset --hard supprime les modifications locales et les commits non poussés.
# sauvegarder son travail au cas où
git commit -a -m "Saving my work, just in case"
git branch my-saved-work
# aligner la branche locale sur le distant
git fetch origin
git reset --hard origin/master
git clean -n -f -d # simulation
git clean -f -d # suppression réelle des fichiers non suivis
git fetch télécharge seulement les nouveautés sans toucher aux fichiers de travail ; git pull télécharge puis intègre (risque de conflit de fusion). Lancer git pull de préférence sur une copie de travail propre (git stash au besoin).
Annuler des commits :
# supprimer des commits non publiés (détruit les modifications locales)
git reset --hard <commit>
# annuler des commits déjà publiés par de nouveaux commits
git revert a867b4af 25eee4ca 0766c053
git revert HEAD~2..HEAD
git revert -m 1 <merge_commit_sha> # annuler un commit de fusion
Restaurer un fichier :
git checkout 'master@{7 days ago}' -- path/to/file.txt
git checkout <commit> path/to/file
Déplacer les derniers commits vers une nouvelle branche :
git branch newbranch
git reset --keep HEAD~3 # recule master de 3 commits
git checkout newbranch
Branches
git branch # locales
git branch -r # distantes
git branch -a # toutes
git remote update origin --prune
git checkout -b my-branch-name
git checkout my-branch-name
git checkout --track origin/my-branch-name
git push -u origin HEAD
git merge my-branch-name
git branch -d my-branch-name # supprime si fusionnée
git branch -D my-branch-name # supprime quoi qu'il arrive
git push origin --delete my-branch-name
git rebase master
Tags
git tag -a v1.4 -m "my version 1.4"
git tag
git push origin <tag_name>
git push --tags
git push --follow-tags
git config --global push.followTags true
git describe --tags --exact-match
git tag --points-at HEAD
Fins de ligne
Message LF will be replaced by CRLF sous Windows :
git config --global core.autocrlf false
Sous-modules
git config --global push.recurseSubmodules on-demand
git submodule foreach 'git status'
git pull --recurse-submodules && git submodule update --init --recursive
Outils de diff et de merge
# vimdiff
git config --global diff.tool vimdiff
git config --global merge.tool vimdiff
git config --global mergetool.prompt false
# Meld
git config --global diff.tool meld
git config --global difftool.meld.cmd "'C:/Program Files (x86)/Meld/Meld.exe' \"$LOCAL\" \"$REMOTE\""
git config --global merge.tool meld
git config --global mergetool.meld.cmd "'C:/Program Files (x86)/Meld/Meld.exe' \"$LOCAL\" \"$BASE\" \"$REMOTE\" --output=\"$MERGED\""
git config --global mergetool.prompt false
# Visual Studio Code
git config --global diff.tool vscode
git config --global difftool.vscode.cmd "code --wait --diff \"$LOCAL\" \"$REMOTE\""
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd "code --wait \"$MERGED\""
git config --global mergetool.prompt false
Cache GPG sous Windows (PowerShell)
Vérifier la configuration de l'agent GPG :
Get-Content "$(gpgconf --list-dirs homedir)\gpg-agent.conf"
Les paramètres default-cache-ttl, max-cache-ttl, default-cache-ttl-ssh et max-cache-ttl-ssh définissent la durée de conservation de la passphrase.
Tester une signature sans créer de commit dans la branche :
git commit-tree -S -m "GPG cache test" 'HEAD^{tree}'
- Si un hash est retourné directement, la signature a réussi sans passphrase.
- Si GPG demande la passphrase, elle n'était plus en cache.
- Aucun changement n'est fait dans la branche ni dans l'historique.
Forcer GPG à redemander la passphrase :
gpgconf --kill gpg-agent
L'agent redémarre automatiquement au prochain usage.
gpgconf --list-options gpg-agent | Select-String "cache-ttl"
Remarques
gpgconf --kill gpg-agentvide le cache de toutes les clés gérées par l'agent.- GPG ne permet pas de consulter directement le temps restant dans le cache.