Description

Ce TP vous montre comment reporter un ou plusieurs commits précis d’une branche vers une autre sans fusionner toute la branche source. Idéal pour hotfix, backport ou récupération d’une correction isolée. Vous apprendrez le cherry-pick simple, multiple, sans commit automatique, la gestion des conflits, l’annotation -x et la manipulation de merge commits.

Objectifs pédagogiques

• Repérer et appliquer un commit précis sur la branche courante
• Cherry-picker plusieurs commits contigus ou non
• Gérer les conflits et finaliser avec --continue ou --abort
• Annoter la provenance avec -x et éditer le message si besoin
• Traiter un merge commit avec -m et revenir en arrière avec git revert

Contexte

Vous travaillez sur feature-x et souhaitez appliquer un correctif sur main sans merger toute la branche. Vous disposez des SHA des commits à reporter et devez conserver un historique propre pour faciliter la Pull Request.

Étapes et commandes

1) Préparer la branche cible et identifier les commits

git fetch origin
git checkout main
git pull --ff-only
git log --oneline origin/feature-x -10

2) Cherry-pick d’un seul commit

git cherry-pick <SHA>

Avec annotation : git cherry-pick -x <SHA>

Éditer le message : git cherry-pick -x --edit <SHA>

3) Cherry-pick de plusieurs commits

Non contigus : git cherry-pick <SHA1> <SHA2>

Plage contiguë : git cherry-pick A^..B

4) Appliquer plusieurs commits mais faire un seul commit

git cherry-pick -n <SHA1> <SHA2>
git commit -m "Backport: corrections X et Y depuis feature-x"

5) Gérer les conflits

git cherry-pick <SHA>
# résoudre les conflits
git add <fichiers_resolus>
git cherry-pick --continue
# abandonner
git cherry-pick --abort

6) Cherry-pick d’un merge commit

git cherry-pick -m 1 <SHA_MERGE>

7) Vérifier et pousser

git log --oneline --decorate -5
git push origin main

8) Revenir en arrière

Avec commit partagé : git revert <SHA>

Local et non partagé : git reset --hard HEAD^

9) Éviter les doublons

git log --oneline --cherry main...origin/feature-x

Résumé

Le cherry-pick permet de reporter un commit précis sur la branche courante. Utilisez -x pour tracer l’origine, -n pour grouper plusieurs commits en un seul, et gérez les conflits avec --continue ou --abort. Pour un merge commit, n’appliquez le cherry-pick que si nécessaire. Pour annuler, utilisez git revert ou git reset --hard si non partagé.