Module 4Mettre en œuvre des outils de gestion de versions et de mesure de la qualité du code
Chapitre 7 sur 11
Commandes Git, branches, conflits de fusion, rôles GitLab, fork et merge requests, GitLab et GitHub.
Objectifs
Avec ce chapitre, tu sauras…
init, status, add, commit, log, clone, pull, push ;Leçon 1
| Type | Principe | Exemples |
|---|---|---|
| locale | l'historique est sur la même machine que les fichiers | les copies projet_v2_final_VRAI.zip, l'historique d'un traitement de texte |
| centralisée | un serveur central garde l'historique ; chaque poste n'a que la dernière version des fichiers et doit être connecté pour enregistrer | CVS, SVN (Subversion), TFVC de Microsoft |
| distribuée (décentralisée) | chaque développeur a une copie complète du dépôt avec tout l'historique ; un dépôt distant (souvent sur une plateforme) sert à échanger | Git, Mercurial |
Leçon 2
| Notion | Définition |
|---|---|
| dépôt (repository) | l'historique complet du projet, stocké dans le dossier caché .git (on n'y touche jamais à la main) |
| commit | un instantané enregistré du projet, avec un auteur, une date, un message et un identifiant unique (une empreinte SHA-1 : 80b1ab0…) ; une version |
| branche (branch) | une ligne de développement indépendante, une variante du projet ; la branche principale s'appelle main (ou master dans les anciens dépôts) |
Leçon 3
Vidéo · À regarder
FRApprendre Git & GitHub en 13 minutes - Tutoriel débutant 2026
Comment Coder · YouTube
Leçon 4
| Commande | Rôle |
|---|---|
git init | créer un nouveau dépôt vide dans le dossier courant |
git clone <url> | copier un dépôt distant existant (avec tout son historique) sur sa machine |
git status | afficher l'état : fichiers modifiés, ajoutés à l'index, non suivis |
git add <fichier> ou git add . | ajouter des modifications à l'index |
git commit -m "message" | enregistrer l'index dans l'historique |
Leçon 5
| Commande | Rôle |
|---|---|
git branch | lister les branches (l'actuelle est marquée d'une *) |
git switch -c B1 | créer la branche B1 et passer dessus (ancien : git checkout -b B1) |
git switch main | revenir sur main |
git merge B1 | fusionner B1 dans la branche actuelle |
git branch -d B1 | supprimer la branche B1 (déjà fusionnée) |
Leçon 6
<<<<<<<, =======, >>>>>>>.git add README.mdgit commit -m "Fusionne branche2 en résolvant le conflit du titre"Leçon 7
| Git | GitLab |
|---|---|
| un logiciel installé sur ta machine | une plateforme web (ou un serveur d'entreprise) |
| gère l'historique en local | héberge les dépôts distants et organise la collaboration |
| ligne de commande | interface web : graphe des commits, fichiers, branches, tags, README, tickets, merge requests |
gitlab.com, inscris-toi ; pour utiliser HTTPS en ligne de commande, crée un jeton d'accès personnel (Paramètres → Jetons d'accès) ou ajoute une clé SSH.Leçon 8
| GitLab | GitHub | |
|---|---|---|
| éditeur | GitLab Inc. | Microsoft (depuis 2018) |
| code de la plateforme | open source (édition Community) ; on peut l'installer gratuitement sur son propre serveur | propriétaire ; version installable (Enterprise Server) payante |
| dépôts privés | gratuits | gratuits (depuis 2019) |
| CI/CD |
1Git est un système de gestion de versions…
2La commande qui ajoute un fichier à l'index est…
3git pull correspond à…
4Pour créer une branche et passer dessus :
5Un conflit de fusion arrive quand…
6Après avoir corrigé un fichier en conflit, on tape…
7Par défaut sur GitLab, peut pousser directement sur la branche protégée main :
8L'équivalent GitHub d'une merge request est…
L'essentiel du chapitre
origin) ; trois zones : répertoire de travail → add → index → commit → dépôt.init, clone, status, add, commit -m, log --oneline --graph, diff, pull (= fetch + merge), push, restore, revert.switch -c, switch, merge, branch -d, push origin <branche> ; conflit : marqueurs <<<<<<<, =======, >>>>>>>, choisir, add, commit (merge --abort pour annuler).main protégée ; fork (origin et upstream) ; merge request = revue + pipeline + fusion.| un pointeur vers le commit (et la branche) sur lequel on travaille actuellement |
| dépôt distant (remote) | une copie du dépôt sur un serveur (GitLab, GitHub), appelée par défaut origin |
| Zone | Contenu |
|---|---|
| répertoire de travail (working directory) | les fichiers du projet tels qu'ils sont sur ton disque, avec tes modifications |
| index (staging area, zone de transit) | les modifications sélectionnées pour le prochain commit |
| dépôt (HEAD) | les modifications enregistrées dans l'historique |
Vidéo · À regarder
FRLES BASES DE GIT (tuto débutant)
Graven - Développement · YouTube
git log --oneline --graph | afficher l'historique des commits |
git diff | voir les modifications pas encore ajoutées à l'index |
git pull | récupérer les commits du dépôt distant et les fusionner dans la branche locale (fetch + merge) |
git push | envoyer ses commits locaux vers le dépôt distant |
git fetch | récupérer les commits distants sans les fusionner |
git restore <fichier> | annuler les modifications non ajoutées d'un fichier (revenir à la version du dernier commit) |
| Situation | Commande |
|---|---|
| annuler les modifications d'un fichier non ajouté | git restore README.md |
| retirer un fichier de l'index (garder les modifications) | git restore --staged README.md |
| corriger le message du dernier commit (pas encore poussé) | git commit --amend -m "Nouveau message" |
| annuler un commit déjà poussé, proprement | git revert <commit> : crée un nouveau commit qui fait l'inverse |
| tout jeter et revenir à l'état du serveur | git fetch origin puis git reset --hard origin/main : dangereux, les modifications locales sont perdues |
Vidéo · À regarder
FRApprendre Git & GitHub en 13 minutes - Tutoriel débutant 2026
Comment Coder · YouTube
git push origin B1 | publier la branche sur le dépôt distant (sinon personne d'autre ne la voit) |
git push origin --delete B1 | supprimer la branche sur le dépôt distant |
Vidéo · À regarder
FRGit - Comprendre le système de branches en 7 minutes (tutoriel complet pour débutant)
YouTube (FR) · YouTube
git status (plus rien à fusionner) et git log --oneline --graph.git branch -d branche1 branche2, et sur le dépôt distant git push origin --delete branche1 branche2.Vidéo · À regarder
FRGIT : résoudre un MERGE CONFLICT sans PANIQUER (cas pratique)
YouTube (FR) · YouTube
git clone https://gitlab.com/ista-fs/kitab.git puis cd kitab.git add, git commit -m "…", puis git push : le README apparaît sur la page du projet.git remote add origin https://gitlab.com/ista-fs/kitab.git puis git push -u origin main.| Rôle | Droits principaux |
|---|---|
| Guest | voir le projet (s'il est privé : seulement les tickets) et créer des tickets |
| Planner | gérer les tickets, epics, jalons et la planification (rôle ajouté en 2024) |
| Reporter | lire le code, gérer les tickets, voir les pipelines |
| Developer | pousser des branches, créer des merge requests, lancer des pipelines |
| Maintainer | en plus : gérer les branches protégées, fusionner dans main, gérer les membres et les paramètres CI/CD |
| Owner | tous les droits, dont la suppression du projet |
git switch main puis git pull.git switch -c KIT-12-filtre-prix.git push -u origin … puis créer la merge request vers main.Vidéo · À regarder
FRComment créer un projet GitLab et gérer les branches
YouTube (FR) · YouTube
| GitHub Actions, intégré depuis 2019 |
| demande de fusion | merge request | pull request |
| philosophie | une plateforme DevOps complète en un seul outil | le plus grand réseau de développeurs et de projets open source ; écosystème d'intégrations |
| limites de l'offre gratuite (en ligne) | 400 minutes de CI par mois, 5 utilisateurs par groupe privé | 2 000 minutes d'Actions par mois pour les dépôts privés, illimité pour les publics |
Vidéo · À regarder
FRApprendre Git & GitHub en 13 minutes - Tutoriel débutant 2026
Comment Coder · YouTube
Le résumé range parmi les « outils de gestion de versions » les wikis (Moodle, MediaWiki) et les traitements de texte (Office, Google Docs) : ce sont des logiciels qui ont un historique des versions, pas des systèmes de gestion de versions du code. Il cite aussi TFS (Team Foundation Server) comme solution centralisée payante : TFS est devenu Azure DevOps Server, et propose aussi Git.
Git est un logiciel libre de gestion de versions distribuée, créé en 2005 par Linus Torvalds pour le développement du noyau Linux. C'est aujourd'hui le standard de fait. Tout dépôt Git (repository, repo) contient l'intégralité de l'historique : chaque développeur travaille à son rythme dans son dépôt local, et des commandes synchronisent les dépôts entre eux.
git --version # git version 2.43.0 (par exemple)
git config --global user.name "Salma Alaoui" # le nom qui apparaîtra dans les commits
git config --global user.email "salma@example.com"
git config --global init.defaultBranch main # la branche principale s'appellera main
git config --list # vérifier la configurationSous Windows, l'installateur de git-scm.com fournit Git Bash, un terminal qui comprend les commandes Unix. Taper git seul affiche la liste des commandes ; git help commit ouvre l'aide d'une commande.
Ce que tu vas voir (3 min) : les chapitres « Comment installer Git ? ». Le formateur installe Git et vérifie l'installation.
Les branches permettent de développer une fonctionnalité isolée des autres, sans casser la branche principale. Quand elle est terminée (et testée), on la fusionne (merge) dans main.
Un conflit de fusion se produit quand deux branches ont modifié la même partie d'un même fichier de façons différentes. Git ne peut pas choisir : il insère les deux versions dans le fichier, entourées de marqueurs, et laisse le développeur décider du contenu final.
Le scénario du résumé, rejoué ici en vrai :
git switch -c branche1
echo "# Kitab, librairie en ligne de Rabat" > README.md
git commit -am "Précise la ville dans le titre"
git switch main
git switch -c branche2
echo "# Kitab, la librairie en ligne" > README.md
git commit -am "Reformule le titre"
git switch main
git merge branche1 # Fast-forward : aucun problème
git merge branche2 # CONFLICT (content): Merge conflict in README.md
# Automatic merge failed; fix conflicts and then commit the result.
git status # both modified: README.md<<<<<<< HEAD
# Kitab, librairie en ligne de Rabat
=======
# Kitab, la librairie en ligne
>>>>>>> branche2Entre <<<<<<< HEAD et ======= : la version de la branche actuelle (main, qui contient déjà branche1). Entre ======= et >>>>>>> branche2 : la version de la branche qu'on fusionne.
Résoudre le conflit
GitLab est une plateforme de développement collaboratif basée sur Git, disponible en ligne (gitlab.com) ou installable sur ses propres serveurs (édition Community, open source). Elle héberge les dépôts et y ajoute tout le cycle DevOps : gestion de projet (tickets, tableaux, jalons), revue de code (merge requests), CI/CD intégrée (chapitre 10), registre de conteneurs, sécurité, déploiement, supervision.
Créer un projet et pousser le code
Créer un projet GitLab et le relier au dépôt local
Les deux plateformes reposent sur Git : on migre facilement de l'une à l'autre (dépôts, wikis, tickets, merge/pull requests).
En équipe : (1) créez le projet kitab sur GitLab dans un groupe, ajoutez les membres avec le bon rôle et vérifiez que main est protégée ; (2) chacun clone le dépôt ; (3) chacun crée une branche nommée d'après un ticket Jira, ajoute un fichier ou une page, pousse et ouvre une merge request ; (4) un camarade relit et commente, le Maintainer fusionne ; (5) provoquez volontairement un conflit sur le README (deux branches) et résolvez-le ; (6) faites une capture de git log --oneline --graph.
Remets dans l'ordre les commandes pour : créer un dépôt local, y ajouter un fichier index.html, l'enregistrer, le relier au projet GitLab https://gitlab.com/ista-fs/vitrine.git et l'envoyer : (a) git commit -m "Ajoute la page d'accueil" ; (b) git push -u origin main ; (c) git init ; (d) git remote add origin https://gitlab.com/ista-fs/vitrine.git ; (e) git add index.html.
Les trois zones
répertoire de travail ── git add ──► index (staging area) ── git commit ──► dépôt (.git)
(les fichiers que tu (ce qui partira dans (l'historique des
modifies) le prochain commit) commits, HEAD)
◄─────────────────────────── git restore / git switch ───────────────────────────Elle permet de faire des commits précis : si tu as corrigé un bug et commencé une nouvelle fonctionnalité dans deux fichiers, tu ajoutes d'abord le fichier du bug (git add), tu fais un commit « Corrige… », puis tu fais un autre commit pour la fonctionnalité. Un bon commit = une modification cohérente, avec un message clair.
Ce que tu vas voir (3 min) : les chapitres « Qu'est-ce que Git ? », « Exemple sans Git », « Résumé », « Contexte ». Le formateur explique ce qu'est Git avec un exemple de projet géré sans Git, puis résume l'intérêt de la gestion de versions.
mkdir kitab && cd kitab
git init # Initialized empty Git repository in …/kitab/.git/
echo "# Kitab" > README.md
git status --short # ?? README.md (fichier non suivi)
git add README.md
git commit -m "Ajoute le README" # [main (root-commit) 80b1ab0] Ajoute le README
git log --oneline # 80b1ab0 Ajoute le READMELe résumé utilise git checkout pour changer de branche et pour annuler les modifications d'un fichier (git checkout -- <fichier>). Ces commandes fonctionnent toujours, mais depuis Git 2.23 (2019), on recommande deux commandes plus claires : git switch pour changer de branche et git restore pour restaurer un fichier. Le résumé écrit aussi git push origin master : les dépôts récents (GitLab, GitHub) utilisent main comme branche principale. Enfin, git add * ne prend pas les fichiers cachés (comme .gitignore) : préfère git add ..
Tableau: Annuler
Ce que tu vas voir (5 min) : les chapitres « Utiliser Git : les commandes essentielles », « Aller dans le dossier du projet », « git init », « git add », « git commit », « git log », « À retenir : le cycle Git ». Il utilise les commandes essentielles dans un projet : git init, git add, git commit, git log, puis résume le cycle Git.
Quand on fusionne, Git combine automatiquement les modifications. Si la branche main n'a pas bougé depuis la création de la branche, la fusion est une simple avance rapide (fast-forward). Sinon, Git crée un commit de fusion.
Ce que tu vas voir (vidéo courte, entièrement sur ce sujet) : le système de branches de Git : créer une branche, passer d'une branche à l'autre, travailler sans casser la branche principale, puis fusionner. Ce sont les branches de cette section.
* 25cf6ff Fusionne branche2 en résolvant le conflit du titre
|\
| * 8594832 Reformule le titre
* | dcef640 Précise la ville dans le titre
|/
* 80b1ab0 Ajoute le READMEFaire des branches courtes (quelques jours au plus), récupérer souvent les changements de main (git pull), faire de petits commits, et se répartir le travail par fichier ou par fonctionnalité. Et en cas de panique pendant une fusion : git merge --abort remet tout comme avant.
Ce que tu vas voir (vidéo courte, entièrement sur ce sujet) : un conflit de fusion sur un cas pratique : Git signale le conflit, on lit les marqueurs <<<<<<<, =======, >>>>>>>, on choisit le bon code, puis on termine par git add et git commit. C'est la résolution de conflit de cette section.
Les membres et leurs rôles
Seuls les membres d'un projet peuvent y écrire. On les ajoute dans Gestion → Membres (Manage → Members), en leur donnant un rôle :
Le résumé affirme que « le rôle Developer ne suffit pas » pour pousser des commits et qu'il faut donner le rôle Maintainer. C'est vrai seulement pour la branche protégée : par défaut, la branche principale (main) est protégée et seuls les Maintainers peuvent y pousser ou y fusionner. Un Developer peut pousser toutes les autres branches et proposer ses modifications par une merge request. C'est justement la bonne pratique : on ne pousse pas directement sur main, on passe par une revue.
Le fork
Un fork est une copie d'un dépôt dans ton espace GitLab. Ce n'est pas une commande Git mais une fonction de la plateforme. On l'utilise pour contribuer au projet de quelqu'un sans avoir le droit d'écrire dans son dépôt (projets open source), ou pour démarrer un projet à partir d'un autre.
git clone https://gitlab.com/salma/fsdev.git # le fork (ma copie, en lecture et écriture)
cd fsdev
git remote add upstream https://gitlab.com/fullstack38/fsdev.git # le dépôt d'origine (lecture seule)
git remote -v
# origin https://gitlab.com/salma/fsdev.git (fetch / push)
# upstream https://gitlab.com/fullstack38/fsdev.git (fetch / push)
git pull upstream main # récupérer les nouveautés du projet d'origine
git push origin main # mettre à jour mon forkLe résumé renomme l'origine puis ajoute le fork comme origin : le résultat est le même. La convention la plus courante est d'appeler origin son propre fork et upstream le dépôt d'origine.
La merge request
Une merge request (MR, « demande de fusion », appelée pull request sur GitHub) propose de fusionner une branche dans une autre. Elle montre les différences, permet de commenter le code ligne par ligne (revue de code), lance le pipeline CI/CD (tests, qualité) et n'est fusionnée qu'une fois approuvée. C'est le cœur du travail en équipe sur GitLab.
git switch -c KIT-12-filtre-prix # une branche par ticket Jira (chapitre 6)
# … modifications …
git add .
git commit -m "KIT-12 Ajoute le filtre par prix"
git push -u origin KIT-12-filtre-prix
# GitLab répond avec un lien direct :
# remote: To create a merge request for KIT-12-filtre-prix, visit:
# remote: https://gitlab.com/ista-fs/kitab/-/merge_requests/new?merge_request%5Bsource_branch%5D=KIT-12-filtre-prixDepuis l'interface : Code → Merge requests → Nouvelle merge request → choisir la branche source et la branche cible → Comparer les branches → titre, description, relecteur → Créer.
Le flux de travail d'une équipe (feature branch)
Ce que tu vas voir (vidéo courte, entièrement sur ce sujet) : la création d'un projet GitLab et la gestion de ses branches dans l'interface web. Tu vois l'interface web de GitLab présentée dans cette section.
Le tableau du résumé (repris d'un article ancien) est en grande partie dépassé : il indique que les dépôts privés de GitHub sont payants et que GitHub n'a pas d'intégration continue intégrée. Depuis 2019, GitHub offre les dépôts privés gratuits et GitHub Actions. Les jugements comme « interface compliquée » ou « claire et facile » sont subjectifs. Les quotas gratuits changent régulièrement : vérifie-les sur les sites officiels.
Ce que tu vas voir (jusqu'à la fin) : les chapitres « GitHub », « Créer un compte GitHub », « Créer un dépôt », « Relier GitHub et le dépôt local », « git remote add », « git push », « Le résultat sur GitHub ». Le même travail côté hébergeur : créer un compte et un dépôt, puis git remote add et git push. Les commandes sont identiques avec GitLab.
Pendant git merge KIT-20-prix, Git signale un conflit dans config.php, qui contient :
<<<<<<< HEAD
define('TVA', 0.20);
=======
define('TVA', 0.20);
define('FRAIS_PORT', 25);
>>>>>>> KIT-20-prix(1) Que contient chaque partie ? (2) Écris le contenu final le plus logique. (3) Donne les deux commandes qui terminent la fusion.
Donne le rôle minimal pour chaque personne du projet Kitab : (1) la gérante, qui veut seulement créer des tickets et voir l'avancement ; (2) un stagiaire développeur qui pousse ses branches et ouvre des merge requests ; (3) le lead développeur qui fusionne dans main et configure la CI/CD ; (4) le formateur, qui veut lire le code et voir les pipelines sans rien modifier.