LLI Wiki — My Digital Knowledge Base

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

Schéma des zones Git : dépôt, index et répertoire de travail

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

Schéma d'un rebase de branche feature sur 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}'

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

Captures d'écran

Aide-mémoire illustré des commandes Git

Mastodon LLIMastodon SocialFosstodon