Bienvenue !

Pierre-Julien VILLOUD

https://linkedin.com/pjvilloud

Introduction

Dans ce cours, nous allons parler de système de gestion de version de manière générale, et plus précisément de Git, qui est le plus répandu aujourd'hui.

Système de gestion de version

Un système de gestion de version est un logiciel permettant aux développeurs de travailler ensemble sur un code source commun, tout en gardant un historique de leur travail, et ce tout au long du développement.

Les développeurs peuvent travailler simultanément (même sur des fichiers communs) sans qu'ils voient leurs modifications écrasées.
Il est possible de travailler simultanément sur des versions différentes du code.
Il est possible de revenir à des versions antérieures du code à tout moment
Il est possible de savoir qui a effectué telle ou telle modification, quand, où est pourquoi.

Il existe deux types de systèmes de gestion de version, le système centralisé ou décentralisé.

Système centralisé vs Système décentralisé

Le système centralisé (CVS, SVN) oblige à avoir un serveur principal tout le temps accessible tandis que le système décentralisé (Git, Mercurial...) permet de travailler sans, même si un serveur central permet tout de même la mise en commun du code.

De nos jours, ce sont les systèmes décentralisés qui sont le plus souvent utilisés (du moins pour les nouveaux projets) car plus souples et avec des fonctionnalités plus poussées.

Installation

Git est disponible sur les Linux, Mac et Windows et peut être utilisé directement en ligne de commande ou par l'intermédiaire d'un logiciel graphique.

Windows/Mac : Git ou Github Desktop
Linux : Git ou sudo apt-get install git
SourceTree
Dans votre IDE...

Si vous n'en n'avez pas déjà un, créer un compte sur Github en choisissant un nom d'utilisateur me permettant de vous identifier (ex pdupont pour Pierre Dupont)

Nous verrons en priorité l'utilisation en ligne de commande, permettant de faire toutes les commandes possibles

Configuration

Commençons par quelques opérations de configuration avec l'outil en ligne de commande. Ces commandes sont exécutables dans un terminal classique sur Linux et Mac. Sur Windows, on utilisera Git Bash ou Git Shell.

git config --global user.name "Votre nom"
git config --global user.email "Votre email"
git config --global color.ui auto

Les deux premières commandes permettront de mieux vous identifier lors de vos différentes actions tandis que la dernière permet d'avoir un affichage coloré au niveau de la ligne de commande.

Les Repository

Un Repository ou dépôt rassemble la totalité des fichiers et répertoires associés à un projet, ainsi que l'historique de toutes les modifications effectuées (appellées commits). Les fichiers contenant les données sur l'historique sont situées dans le répertoire .git.

Créer un nouveau repository ou dépôt local dans le répertoire courant
git init nom_du_repository

Télécharger un repository existant
git clone url_du_repository

Créer en ligne de commande un repository nommé ipi-git-local, puis créer un repository sur github nommé ipi-git-github .

Cloner le repository ipi-git-github ainsi que celui situé à l'adresse https://github.com/votreuser/ipi-git-github.git

Effectuer des changements

Lorsque vous allez effectuer des changements sur le code de votre projet, vous allez vouloir les partager avec les autres. De la même manière, vous aller vouloir récupérer les changements effectués par les autres.

1 - Faire des changements
2 - Préparer les changements pour le versioning
3 - Enregistrer les changements dans votre repository
4 - Envoyer ces changements sur le repository central
5 - Faire des changements
6 - Voir les modifications qui n'ont pas été enregistrées dans le repository
7 - Voir les différences avec le repository

Je crée le fichier portant mon nomvilloud.txt
git add villoud.txt
git commit -m "Création du fichier villoud.txt"
git push
J'ajoute mon nom et mon prénom dans le fichier villoud.txt
git status
git diff villoud.txt

Effectuer ce processus dans le repository ipi-git-local et ipi-git-github et constater à chaque étape le contenu des repository locaux et distants (le cas échéant).

Travailler à plusieurs

Si on essaye maintenant de travailler ensemble sur le même repository ipi-git-200-ex, nous allons rencontrer un blocage nous empêchant d'envoyer nos changements sur le repository.

1 - Faire des changements
2 - Préparer les changements pour le versioning
3 - Enregistrer les changements dans votre repository
4 - Envoyer ces changements sur le repository central
5 - Récupérer les changements effectués depuis ma dernière mise à jour
6 - Envoyer ces changements sur le repository central

Je crée le fichier portant mon nomdupond.txt
git add dupond.txt
git commit -m "Création du fichier dupond.txt"
git push
git pull
git push

Avant d'envoyer de nouveaux changements sur un repository, il faut d'abord s'assurer d'être à jour par rapport à ce dernier.

Travailler à plusieurs (2)

Nous nous sommes sortis assez facilement du problème précédent grâce au merge automatique de Git car nous travaillions sur des fichiers différents. Que se passe-t-il si nous travaillons sur le même fichier ?

1 - Faire des changements sur le même fichier
2 - Préparer les changements pour le versioning
3 - Enregistrer les changements dans votre repository
4 - Envoyer ces changements sur le repository central
5 - Récupérer les changements effectués depuis ma dernière mise à jour
6 - Envoyer ces changements sur le repository central

Je modifie listeNoms.txt pour ajouter mon prénom à la suite de mon nom
git add listeNoms.txt
git commit -m "Modification du fichier listeNoms.txt"
git push
git pull
git push

La fusion automatique a également fonctionné car même si Git constate que des modifications ont été faites en parallèle sur un même fichier, elles ne l'ont pas été sur la même ligne. Que se passe-t-il maintenant si vous ajouter votre nom à la fin du fichier noms.txt et que vous refaites les mêmes manipulations ?

Les conflits

Tout va bien lorsqu'on travaille sur des fichiers différents, ou sur des parties différentes d'un même fichier. Cependant, il peut y avoir des conflits lorsque plusieurs personnes modifient la même ligne d'un même fichier.

Git n'arrive pas à fusionner automatiquement les contenus qu'il faut alors fusionner manuellement...

Gestion des conflits

Lors d'un conflit, Git vous redonne donc la main afin que vous résolviez le(s) conflit(s) vous-même en fournissant à l'intérieur du fichier incriminé, les modifications qui ont été faites des deux côtés. Cela ressemble à ça :

Fichier noms.txt


              DURAND

              <<<<<<< HEAD 

              VILLOUD

              =======

              FAURE

              >>>>>>> 97ef45b...

Contenu sans conflit
Où pointe votre copie locale
Votre modification
Séparateur
Modification distante
hash du commit distant en cause

Pour résoudre le conflit :

Modifier le fichier manuellement en faisant attention à bien garder les modifications distantes et les vôtres
Ne pas oublier de supprimer les éléments ajoutés par Git (<<<<<< HEAD...)
git add noms.txt
git commit
git push

Il est alors nécessaire de résoudre manuellement le conflit lorsque Git n'a pas réussi à le faire automatiquement. Il faut être particulièrement attentif lors de la résolution de conflit afin de prendre en compte toutes les modifications et ne pas supprimer celles des autres personnes.

Gestion des conflits (2)

Cela peut vite devenir compliqué et illisible lorsqu'on doit résoudre plusieurs conflits. On peut donc utiliser un logiciel tierce pour nous aider à le faire. La plupart des IDE ou des GUI pour Git possèdent leur outil.

Vous pouvez aussi paramétrer Git pour lancer un logiciel de résolution de conflits (comme Meld, voir ici pour un exemple de configuration) lorsqu'il détecte un conflit.

Les branches

Afin notamment d'éviter de systématiquement devoir récupérer les changements des autres (et régler les potentiels conflits) pour pousser les siens, on peut utiliser le mécanisme des branches. Cela permet aussi de pouvoir pousser son code même s'il n'est pas terminé sans pour autant impacter les autres développeurs.

A la création d'un repository, une seule branche existe, la branche main. Ce mécanisme de branches permet également de gérer le développement parallèle de plusieurs fonctionnalités, ou la maintenance des différentes versions d'un logiciel. Pour approfondir voir les différents workflows.

Manipuler les branches

Voyons maintenant les commandes pour manipuler ces branches.

Voir toutes les branches
Créer une nouvelle branche
Switcher votre copie de travail sur la branche
Fusionner le contenu d'une branche dans l'actuelle
Supprimer une branche
Pousser une branche locale sur le dépôt distant

git branch
git branch nom-branche
git checkout nom-branche
git merge nom-branche
git branch -d nom-branche
git push --set-upstream origin mabranche

Manipuler les branches (2)

Prenons un cas concret

Créer la branche fix-votrenom
Vérifier sur quelle branche vous êtes
Vous positionner sur cette nouvelle branche
Supprimer le fichier votrenom.txt et commiter la modification
Entre temps une modification a été faite sur main.
Incorporer les modifications de main sur fix-votrenom
Répercuter les modifications de fix-votrenom sur main
Supprimer la branche fix-votrenom
Pousser main

git branch fix-villoud
git branch
git checkout fix-villoud
git commit -am "Suppression du fichier villoud.txt"
git checkout main git pull
git checkout fix-villoud git merge main
git checkout main git merge fix-villoud
git branch -d fix-villoud
git push

A noter que nous n'avons pas poussé sur origin la branche fix-votrenom, elle reste donc uniquement sur notre repository local. Il est possible de l'envoyer sur le repository distant avec git push --set-upstream origin fix-votrenom

Revenir en arrière

Voici d'autres commandes permettant d'effectuer diverses actions.

Consulter une autre version du code
Mettre de côté les modifs non commitées pour les appliquer plus tard
Annuler tous les commits suivants (garde les modifications localement)
Supprime tous les commits suivants (donc toutes les modifications)
Supprimer/Déplacer un fichier
Supprimer un fichier uniquement de git
Inverser un commit

git checkout [hash-commit|nom-branche|nom-tag]
git stash => git stash pop
git reset [hash-commit]
git reset --hard [hash-commit]
git rm fichier / git mv fichier fichier2
git rm --cached fichier
git revert mon-commit

Quand vous utiliser un IDE prenant en charge Git, certaines de ces opérations sont faites toutes seules, lorsque vous supprimez ou déplacez un fichier.

Revenir en arrière (2)

Il existe plusieurs cas pour lesquels un développeur souhaite revenir en arrière. Voyons quelques exemples avec un cas concret.

Je fais des modifications que je souhaite finalement annuler
Je souhaite enlever les modifications en cours (que je garde en mémoire)
Je change de branche et fais des modifications que je commit
Je veux supprimer mon dernier commit
Je reviens sur ma branche et applique les modifications gardées en mémoire
Je veux annuler mon précédent commit qui a été pourtant été poussé
Je veux consulter l'état du repository au premier commit
Je reviens au dernier commit d'une branche

git reset --hard
git stash
git checkout fix-villoud git commit -am "mes modifications"
git reset HEAD^
git checkout main git stash pop ...
git revert [hash-commit] ...
git checkout [hash-commit]
git checkout main

Il est toujours possible de revenir en arrière sur des modifications, même commitées, sans trop de problème. Mais il faut être très attentif lorsqu'on modifie des commits déjà poussés sur le repository distant (et donc potentiellement récupérés par d'autres collaborateurs)

Bonus

Quelques commandes utiles

Voir l'historique des commits
Voir l'historique des commits de manière graphique
Marquer une version/Voir les versions
Prendre un commit dans une autre branche et l’appliquer

git log
git log --graph
git tag -a nom-tag / git tag -l
git cherry-pick mon-commit

Expérimentez ces commandes dans votre repository

La notion de `fork`

Lorsque vous souhaitez contribuer à un repository, vous rencontrerez la notion de fork. Le fork permet de copier le repository d'un compte (Github ou Gitlab par exemple) sur votre propre compte.

Je fork le projet ipi-git-200-fork
Je clone le projet votreuser/ipi-git-200-fork en local
Je fais des modifications que je commit et push
Je lie mon repository local avec pjvilloud/ipi-git-200-fork
Je fusionne la branche main de repository de référence qui contient une nouvelle modification, dans ma branche main
Je pousse les modifications sur mon repository
Je soumets mes modifications pour qu'elles puissent être fusionnées sur la branche main de pjvilloud/ipi-git-200-fork

Aller sur pjvilloud/ipi-git-200-fork et cliquer sur le bouton
git clone https://github.com/votreuser/ipi-git-200-fork
git commit -am "mes modifications" git push
git remote add upstream https:.../pjvilloud/ipi-git-200-fork
git fetch upstream
git merge upstream/main
git push
Création d'une Pull Request (ou Merge Request sur Gitlab) de votreuser/ipi-git-200-fork:main vers pjvilloud/ipi-git-200-fork:main. Validation

Lorsqu'on travaille sur un fork, on ne peut normalement pas pousser nos modifications directement sur le repository de référence, cela doit passer par une Pull Request (ce qui implique généralement une revue de code) qui est validée par une personne habilitée (propriétaire du repository de référence, ou lead developer de l'équipe par exemple).

Quelques conseils

Quelques conseils et bonnes pratiques :

Approfondir Git !!
Commiter tôt et souvent
Choisir un workflow et s'y tenir
Rédigez des messages de commits pertinents
Attention à ne pas commiter vos fichiers persos .gitignore
Et surtout pas de panique...

Pour aller plus loin

Voici quelques ressources pour approfondir vos connaissances sur Git

Bienvenue !

Pierre-Julien VILLOUD

pjvilloud@protonmail.com

https://github.com/pjvilloud

https://linkedin.com/pjvilloud

http://pjvilloud.github.io

Introduction

Système de gestion de version

Système centralisé vs Système décentralisé

Installation

Configuration

Les Repository

Effectuer des changements

Travailler à plusieurs

Travailler à plusieurs (2)

Les conflits

Gestion des conflits

Gestion des conflits (2)

Les branches

Manipuler les branches

Manipuler les branches (2)

Revenir en arrière

Revenir en arrière (2)

Bonus

La notion de `fork`

Quelques conseils

Pour aller plus loin

Bienvenue !

Pierre-Julien VILLOUD

pjvilloud@protonmail.com

https://github.com/pjvilloud

https://linkedin.com/pjvilloud

http://pjvilloud.github.io

Introduction

Système de gestion de version

Système centralisé vs Système décentralisé

Installation

Configuration

Les Repository

Effectuer des changements

Travailler à plusieurs

Travailler à plusieurs (2)

Les conflits

Gestion des conflits

Gestion des conflits (2)

Les branches

Manipuler les branches

Manipuler les branches (2)

Revenir en arrière

Revenir en arrière (2)

Bonus

La notion de fork

Quelques conseils

Pour aller plus loin

La notion de `fork`