Лист за преговор: Maîtrise des fondamentaux Git

📋 Plan du Cours

1. Gestion des versions Git
2. Configuration Git
3. Statut et commandes Git
4. Messages de commit
5. Revue de l'historique Git
6. Branches et fusion
7. Gestion des conflits

📖 1. Gestion des versions Git

🔑 Notions clés & Définitions

repository
Un repository, ou dépôt, est un espace de stockage où Git enregistre l’historique complet d’un projet. Il contient tous les fichiers, les commits, les branches et autres métadonnées nécessaires à la gestion des versions.

versionning
Le versionning, ou gestion des versions, désigne le processus de sauvegarde et de suivi des modifications apportées à un projet au fil du temps. Dans Git, cela se réalise via des commits enregistrés dans un repository, permettant de revenir à des états antérieurs ou de suivre l’évolution du code.

branches
Les branches sont des lignes parallèles de développement dans un repository. Elles permettent d’isoler des modifications pour travailler simultanément sur différentes fonctionnalités ou correctifs sans affecter la branche principale.

commit
Un commit est une opération qui enregistre un état précis du projet dans le repository. Il contient un message décrivant les changements effectués et constitue une étape dans l’historique des modifications.

stash
La commande git stash permet de sauvegarder temporairement des modifications non encore commités. Elle facilite le changement de contexte ou de branche sans perdre le travail en cours, en stockant ces modifications dans une pile temporaire.

📝 Points essentiels

Git permet de gérer différentes versions d’un projet via des commits enregistrés dans un repository. Ces commits constituent une trace précise de chaque modification, facilitant la restauration ou la comparaison d’états antérieurs.

Les branches jouent un rôle clé en permettant la parallélisation du développement. Elles isolent les modifications, ce qui facilite le travail collaboratif et la gestion de différentes fonctionnalités ou correctifs simultanément.

La commande git stash est un outil pratique pour sauvegarder temporairement des modifications non commités. Elle permet de changer de contexte ou de branche sans perdre le travail en cours, en stockant ces modifications dans une pile que l’on peut réappliquer ultérieurement.

💡 À retenir

Git est un système puissant de gestion d’historique et de versions, utilisant des commits, des branches et des stash pour organiser efficacement le travail collaboratif et le suivi des modifications.

📖 2. Configuration Git

🔑 Notions clés & Définitions

git config : Commande permettant de configurer les paramètres de Git, que ce soit pour définir des options globales ou spécifiques à un dépôt. Elle modifie ou lit les fichiers de configuration de Git.

system config : Fichier de configuration situé au niveau du système, généralement dans un répertoire réservé à l’installation de Git. Il définit des paramètres par défaut pour tous les utilisateurs et dépôts sur la machine.

global config : Fichier de configuration propre à l’utilisateur, stocké dans le fichier ~/.gitconfig. Il contient des réglages qui s’appliquent à tous les dépôts de cet utilisateur, sauf si une configuration locale ou système la surcharge.

local config : Fichier de configuration spécifique à un dépôt, situé dans .git/config à la racine du dépôt. Il a priorité sur les autres niveaux de configuration pour ce dépôt précis.

SSH key : Clé cryptographique utilisée pour sécuriser les échanges entre un utilisateur et un dépôt distant. La génération et la gestion de ces clés permettent d’authentifier l’utilisateur sans mot de passe, renforçant la sécurité des interactions.

📝 Points essentiels

Git utilise trois niveaux de configuration : system, global et local, chacun stocké dans un fichier spécifique. La configuration locale (.git/config) est prioritaire sur la configuration globale (~/.gitconfig) et la configuration système. Cela signifie que si un paramètre est défini à plusieurs niveaux, c’est celui du fichier local qui prévaut. La génération et gestion des clés SSH sont essentielles pour sécuriser les interactions avec les dépôts distants, permettant une authentification fiable et sans mot de passe.

💡 À retenir

Maîtriser la configuration Git, notamment la gestion des différents niveaux et des clés SSH, est crucial pour personnaliser son environnement de travail et sécuriser ses échanges avec les dépôts.

📖 3. Statut et commandes Git

🔑 Notions clés & Définitions

Untracked : Fichier qui n’est pas encore suivi par Git. Il n’apparaît pas dans l’historique des commits et doit être ajouté pour être intégré au suivi.

Modified : Fichier qui a été modifié depuis le dernier commit, mais qui n’a pas encore été préparé pour le commit.

Staged : Fichier modifié qui a été préparé avec la commande git add pour être inclus dans le prochain commit.

git add : Commande permettant de préparer (stager) les fichiers modifiés ou nouveaux afin qu’ils soient inclus dans le prochain commit.

git commit --amend : Commande permettant de modifier le dernier commit, en ajoutant des modifications ou en ajustant le message de commit.

📝 Points essentiels

Les fichiers dans Git peuvent être dans différents états : untracked, modified, ou staged. Ces états déterminent l’action à effectuer. Un fichier untracked doit être ajouté avec git add pour devenir staged. Un fichier modified doit également être staged pour être inclus dans le prochain commit. La commande git add sert à préparer ces fichiers modifiés ou nouveaux pour le commit.

La commande git commit --amend permet de modifier le dernier commit. Elle est utile pour corriger ou compléter un message ou le contenu du commit précédent, évitant ainsi la création d’un nouveau commit.

💡 À retenir

Savoir interpréter le statut des fichiers (untracked, modified, staged) et maîtriser les commandes git add et git commit --amend est essentiel pour un contrôle précis et efficace des modifications dans un dépôt Git.

📖 4. Messages de commit

🔑 Notions clés & Définitions

• message de commit
  AUTEUR (date) : description textuelle associée à une modification dans le système de contrôle de version, permettant de comprendre le contexte et la nature du changement effectué.

• sujet
  AUTEUR (date) : courte ligne de résumé du commit, limitée à 50 caractères maximum, qui indique brièvement l’objectif principal de la modification.

• corps du message
  AUTEUR (date) : partie du message de commit qui suit le sujet, offrant une description détaillée expliquant le pourquoi des changements, plutôt que le comment.

• références d’issues
  AUTEUR (date) : mentions ou liens vers des tickets ou issues liés au commit, permettant de tracer et de contextualiser les modifications dans le cadre du projet.

• conventions de style
  AUTEUR (date) : règles ou standards adoptés pour rédiger les messages de commit, notamment la structure, la longueur du sujet, et la manière d’intégrer les références.

📝 Points essentiels

• Un bon message de commit commence par un sujet court (50 caractères max), suivi d’une ligne vide puis d’une description détaillée.
• Le corps du message doit expliquer le pourquoi des changements, pas le comment, afin de faciliter la compréhension future.
• L’inclusion de références aux issues ou tickets permet de tracer les modifications dans leur contexte, renforçant la traçabilité et la cohérence du projet.

💡 À retenir

Rédiger des messages de commit clairs et structurés facilite la compréhension et la maintenance du code sur le long terme, en permettant à tous les contributeurs de saisir rapidement la nature et la raison des modifications.

📖 5. Revue de l'historique Git

🔑 Notions clés & Définitions

git log
git log est une commande permettant de consulter l’historique des commits dans un dépôt Git. Elle offre plusieurs options d’affichage pour visualiser cet historique, telles que l’affichage sous forme de graphique, de résumé ou de statistiques. Elle est essentielle pour suivre l’évolution du projet et analyser les modifications successives.

--oneline
L’option --oneline de git log affiche chaque commit sur une seule ligne. Elle simplifie la lecture en résumant chaque commit par un identifiant abrégé et son message, facilitant une vue d’ensemble rapide de l’historique.

--graph
L’option --graph ajoute un graphique ASCII représentant la branchement et la fusion des commits dans la sortie de git log. Elle permet de visualiser la structure de l’historique, notamment les branches et les merges, de façon claire et intuitive.

git reflog
git reflog enregistre toutes les actions locales effectuées dans le dépôt, y compris celles qui ne sont pas visibles dans l’historique classique. Il permet de revenir à un état antérieur même après des opérations complexes ou des modifications non validées, en conservant une trace de toutes les références locales.

git reset --hard
La commande git reset --hard permet de revenir à un commit précis en supprimant toutes les modifications non validées dans l’arborescence de travail et dans la zone de staging. Elle est utilisée pour annuler des changements et retrouver un état antérieur du dépôt.

📝 Points essentiels

git log
Permet de consulter l’historique des commits avec plusieurs options d’affichage, telles que le graphique, le résumé ou les statistiques. Ces options facilitent la compréhension de l’évolution du projet et la recherche de modifications spécifiques.

git reflog
Enregistre toutes les actions locales, y compris celles qui ne sont pas visibles dans l’historique classique. Il offre la possibilité de revenir à un état antérieur même après des opérations complexes ou des erreurs, en conservant une trace complète des références locales.

git reset --hard
Permet de revenir à un commit précis, en supprimant toutes les modifications non validées dans l’arborescence de travail. Elle est utile pour annuler rapidement des changements et restaurer un état antérieur du dépôt.

💡 À retenir

Analyser et manipuler l’historique Git, notamment via git log, git reflog et git reset --hard, est essentiel pour comprendre l’évolution du projet et corriger efficacement les erreurs.

📖 6. Branches et fusion

🔑 Notions clés & Définitions

git branch
git branch est une commande qui permet de créer, lister ou supprimer des branches dans un dépôt Git. Elle sert à isoler des développements ou des corrections pour travailler indépendamment de la branche principale ou d’autres branches.

git checkout
git checkout est une commande utilisée pour basculer d’une branche à une autre ou pour restaurer des fichiers dans l’arborescence de travail. Elle permet de changer de contexte de développement en passant d’une branche à une autre.

git merge
git merge est une commande qui combine les modifications de deux branches. Elle intègre le contenu d’une branche dans une autre, pouvant créer un commit de merge si des modifications doivent être fusionnées.

fast-forward
fast-forward désigne une fusion où la branche cible est avancée directement à la position de la branche source, sans créer de commit de merge. Cela se produit lorsque la branche cible n’a pas évolué depuis la divergence.

git rebase
git rebase est une commande qui réapplique les commits d’une branche sur une autre branche, permettant d’obtenir un historique linéaire. Elle modifie la base de la branche pour la faire suivre une autre branche.

📝 Points essentiels

Les branches isolent les développements et facilitent la gestion des fonctionnalités ou corrections. En créant une branche, on peut travailler sur une nouvelle fonctionnalité ou correction sans impacter la branche principale, ce qui facilite la gestion du code et la collaboration.

git merge permet de combiner les modifications de branches différentes. Lorsqu’on fusionne, un commit de merge peut être créé pour enregistrer cette opération, notamment si des modifications conflictuelles doivent être résolues.

git rebase offre une alternative à merge en réappliquant les commits d’une branche sur une autre, ce qui permet d’obtenir un historique plus linéaire. Cela facilite la lecture et la compréhension de l’évolution du projet.

💡 À retenir

La gestion des branches et des fusions est essentielle pour structurer le développement, isoler les travaux et faciliter la collaboration. Le choix entre merge et rebase influence la lisibilité de l’historique et la gestion des conflits.

📖 7. Gestion des conflits

🔑 Notions clés & Définitions

Conflits de merge

• AUTEUR : voir section 4

Résolution de conflits
AUTEUR (date) : La résolution de conflits consiste à intervenir manuellement pour choisir ou combiner les modifications incompatibles afin de finaliser la fusion ou le rebase.

Git rebase interactif
AUTEUR (date) : Le git rebase interactif permet de modifier l’historique des commits, notamment en réorganisant, fusionnant ou supprimant des commits, tout en résolvant les conflits de façon contrôlée.

Git stash pop
AUTEUR (date) : La commande git stash pop permet de récupérer les modifications mises en réserve (stash) et de les appliquer à la branche courante, en intégrant éventuellement des conflits à résoudre.

Git reset
AUTEUR (date) : La commande git reset permet de revenir à un état antérieur de l’historique ou de désindexer des fichiers, ce qui peut être utile pour annuler ou corriger des conflits ou des erreurs.

📝 Points essentiels

Les conflits surviennent lorsque Git ne peut pas fusionner automatiquement des modifications incompatibles. Cela se produit lors d’un merge ou d’un rebase, lorsque deux branches ont modifié la même partie d’un fichier de manière différente. La résolution manuelle des conflits est alors nécessaire pour finaliser l’intégration des modifications. La résolution implique d’éditer les fichiers concernés pour choisir ou combiner les modifications, puis de valider cette intervention. Le git rebase interactif offre une méthode contrôlée pour modifier l’historique, notamment en résolvant les conflits de manière sélective et structurée. La maîtrise de ces outils et processus est essentielle pour maintenir la cohérence et la qualité du code lors des opérations d’intégration.

💡 À retenir

Savoir identifier et résoudre les conflits est indispensable pour garantir la cohérence du projet. La maîtrise du rebase interactif et des commandes comme stash pop ou reset permet de gérer efficacement ces situations et d’assurer une intégration fluide des modifications.

📊 Tableaux de Synthèse

Aspect	Description	Auteur/Source
Repository	Espace de stockage contenant l’historique complet, fichiers, branches, commits	-
Versionning	Processus de sauvegarde et suivi des modifications dans Git	-
Branches	Lignes parallèles pour isoler des développements	-
Commit	Enregistrement d’un état précis avec message	-
Stash	Sauvegarde temporaire des modifications non commités	-
Configuration Git	Niveaux : système, global, local; priorité locale	-
Clé SSH	Sécurisation des échanges avec authentification par clé cryptographique	-
Statut des fichiers	Untracked, Modified, Staged	-
Commande git add	Préparer les fichiers pour le commit	-
git commit --amend	Modifier le dernier commit	-
Message de commit	Sujet (50 caractères max), corps détaillé, références d’issues	-
git log	Visualiser l’historique des commits	-

⚠️ Pièges & Confusions Fréquentes

1. Confondre git add (stager) et git commit (enregistrer).
2. Oublier que la configuration locale (.git/config) prévaut sur la globale (~/.gitconfig).
3. Confusion entre fichiers untracked, modified et staged.
4. Utiliser git commit --amend sans vérifier si le dernier commit est correct, risquant de modifier l’historique de façon inappropriée.
5. Négliger la gestion des clés SSH, ce qui peut empêcher l’accès aux dépôts distants.
6. Mal rédiger les messages de commit, rendant leur compréhension difficile.
7. Ne pas vérifier le statut avec git status avant d’effectuer des opérations importantes.

✅ Checklist Examen

• Connaître la définition de repository et son rôle dans la gestion des versions.
• Maîtriser la différence entre versionning, branches, commits et stash.
• Savoir comment configurer Git à différents niveaux (système, global, local) et l’importance de la priorité locale.
• Comprendre le fonctionnement des états des fichiers : untracked, modified, staged.
• Être capable d’utiliser git add, git commit, et git commit --amend.
• Rédiger un message de commit clair : sujet court, corps explicatif, références d’issues si nécessaire.
• Savoir utiliser git log pour revoir l’historique des commits avec ses différentes options d’affichage.
• Connaître la gestion et la sécurisation via clés SSH pour les interactions distantes.
• Identifier les pièges liés à la modification de commits ou à la gestion des configurations.
• Vérifier le statut avec git status avant toute opération critique.
• Comprendre le rôle et l’utilisation du stash pour sauvegarder temporairement des modifications non prêtes à être commitées.
• Connaître les conventions de style pour rédiger les messages de commit selon les standards adoptés par le projet.