Conduite et Gestion de Projet Systèmes de gestion de version

(1)

Conduite et Gestion de Projet Syst` emes de gestion de version

Thierry Hamon

Bureau H202 Institut Galil´ee - Universit´e Paris 13

&

LISN - Universit´e Paris-Saclay hamon@limsi.fr

https://perso.limsi.fr/hamon/Teaching/P13/CGP-2021- 2022/

(2)

Introduction

Gestion de version :

Maintenance d’un ensemble de fichiers et de leurs versions Utilisation importante dans le d´eveloppement logiciel (gestion du code source) :

Nombreuses fonctionnalités nécessaires au développement logiciel :

Sauvegarde r´eguli`ere des modifications

Historique des modifications (date, nom du d´eveloppeur, zone de code modifi´e)

Partage des fichiers entre plusieurs développeurs Développement en parallèle sur le même fichier Définition de distribution

Maintenance et correction (d´efinition de patch)

(3)

Syst` eme optimiste

Plusieurs utilisateurs peuvent travailler sur le mˆeme fichier en mˆeme temps

le système fait l’hypothèse que les conflits (dus à des modifications) sont rares : les utilisateurs ne travaillent pas sur la même partie du fichier

le syst`eme n’a qu’`a fusionner les modifications (au niveau des lignes)

les conflits sont réglés manuellement par les utilisateurs Autre solution : réserver le fichier à modifier, de manière à travailler en exclusivité

(4)

Syst` eme optimiste

Mode de fonctionnement optimiste : avantages importants un développeur voulant faire modifier un fichier n’est pas empêché par quelqu’un qui a réservé ce même fichier pas de cassure dans le rythme de développement

(5)

D´ epˆ ot / R´ ef´ erentiel

Centralisation des fichiers et des informations associ´ees : Stockage dans une base de donn´ees

Accès local et distant partagé par tous les utilisateurs Sauvegarde des différentes versions des fichiers

Sauvegarde des informations associées aux fichiers et au dépôt Chaque utilisateur travaille sur une copie locale et envoie ses modifications sur le dépôt

(6)

Principe de la gestion de version

Chaque élément (fichier, répertoire, etc.)

est contrôlé par le système de gestion de version se voit associer un numéro de version (révision)

L’enregistrement d’une modification d’un élément de la copie locale provoque une incrémentation du numéro de révision Définition d’une arborescence des versions (organisée suivant un tronc et des branches)

(7)

Principe de num´ erotation des versions

format : m.n.p

voir par exemple la numérotation des noyaux Linux m: numéro de révision majeure

Incrémentation lors d’ajout de fonctionnalités incompatibles avec la version précédente

n: num´ero de r´evision mineure

Incrémentation lors d’ajout de fonctionnalités compatibles avec la version courante (maintenance évolutive)

La parité peut être utilisée pour indiquer la stabilité : pair : version stable

impair : version de d´eveloppement p: num´ero de patch

Incr´ementation lors de la correction de bugs (maintenance corrective)

(8)

Rˆ oles des diff´ erentes arborescences

Distribution :

Identifier des repères dans le développement (phase de développement, version, etc.)

Faciliter le support en figeant des versions Branches :

Correction de bugs

Tester de nouvelles fonctionnalitésrisquées sur des versions antérieures ou en parallèle à la version principale

(9)

Op´ erations principales

import: Initialisation/importation d’un projet dans un d´epˆot

`

a partir d’une arborescence non gérées par un système de gestion de version

checkout: récupération d’un projet dans un dépôt pour obtenir une copie locale

commit: mise à jour du dépôt avec la copie locale update: mise à jour de la copie locale avec le dépôt Synchronisation avec des modifications des autres développeurs

(10)

Terminologie

R´esum´e

Dépôt : ensemble des fichiers sous le système de gestion de version Copie locale : ensemble des fichiers sur la machine locale du développeur Révision : version d’un élément (fichier, répertoire, projet, etc.) du dépôt Tronc : arborescence principale d’un projet

Distribution (tags) : arborescence fig´ee d’un projet

Branches : arborescences secondaires, zones de travail utilisées pour des développements ou des corrections en parallèle à l’arborescence principale Checkout : récupération des fichiers du dépôt dans leur version courante Commit : soumision des modifications et/ou des ajouts de la copie locale Update : Mise à jour de la copie locale par rapport aux fichiers sur le dépôt

(11)

Git

https://git-scm.com

Système de gestion de version distribué (DVCS) rappel : SVN est un système centralisé

Système optimiste, rapide et efficace pour de grands projets Permet le développement collaboratif, non linéaire (branches parallèles)

Commande utilisateur : git

Aide : git helpougit help commande GUI :gitk,qgit, ...

Documentation : https://git-scm.com/doc

Développé par Linus Torvalds pour la gestion du noyau Linux, première version en décembre 2005

(12)

Git

Syst`eme de gestion de version tr`es complet

difficile à maˆıtriser complètement Principes de base simples à apprendre si le modèle sous-jacent est compris

(http://xkcd.com/1597/)

(13)

Principes

Conception similaire à un système de fichiers (adressage, etc.) Commit: instantané (snapshot) du projet (répertoire de travail), désigné par une référence

Fichiers non modifiés : référence au fichier déjà enregistré Utilisation de résumés (clés de hachage) et la compression pour éviter la duplication des données

Identification des r´evisions avec des cl´es de hachage (SHA1)

(14)

Principe de stockage des modifications

Principe de stockage classique (SVN) :

Principe de stockage dans Git :

(15)

Principes

Deux niveaux de d´epˆot :

Dépôt local utilisé la plupart de opérations courantes

(historique d’un projet, différence sur un fichier, commit, etc.) Rapidité de réponse puisqu’on ne passe pas par un serveur distant

Utilisation de Git possible même sans connectivité Internet Dépôt distant (remote) utilisé pour le travail collaboratif Partage des modifications en

poussant (push), int´egrant/tirant (pull)

les modifications sur le serveur Git distant Dépôt préféré : origin

(16)

Architecture Git

Index Copie de travail Index Copie de travail

modification différence ...

édition

édition Dépot Git

distant

Dépot Git local

Dépot Git local (commande git)

Développeur

Développeur (commande git) Administrateur

pull push

clone push

add

commit reset −−hard reset −−hard

clone pull

commit

add

(17)

Principes

Cycle de vie d’un fichier (git status)

untracked: fichier non géré par git unmodified/committed: copie de travail correspondant à la version dans le dépôt

Modified: copie de travail ne correspondant par à la version dans le dépôt

Staged(indexé) : copie de travail marquée pour être incluse dans le prochaincommit

(18)

Flux des donn´ ees dans Git

(19)

Configuration initiale

D´efinition des valeurs par d´efaut pour les commits Stockage dans le fichier$HOME/.gitconfig

$ git config --global --add user.name "Thierry Hamon"

$ git config --global user.email hamon@limsi.fr

$ git config --global core.editor emacs

(20)

Initialisation d’un d´ epˆ ot local

+ Initialisation d’un d´epˆot

Dépot Git distant

Dépot Git local 1b Utilisateur

(git init) Administrateur 1 (git −−bare init)

1b Utilisateur (git init) (commande git)

Développeur

Développeur (commande git)

(21)

Initialisation d’un d´ epˆ ot local

Utilisation de la commandegit initdans le répertoire dédié au dépôt (icigit-cgp)

Cr´eation de la branche principale (master)

$ mkdir git-cgp

$ cd git-cgp

$ git init

Dépôt Git vide initialisé dans /home/thierry/git-cgp/.git/

$ ls -a ./ ../ .git/

$ ls -a .git

./ ../ branches/ config description HEAD hooks/

info/ objects/ refs/

ou

git init git-cgp;cd git-cgp

(22)

Consultation de l’´ etat de la copie de travail

1cstatus, log 1cstatus, log

Dépot Git distant

Développeur

(23)

Consultation de l’´ etat de la copie de travail

$ git status Sur la branche master Validation initiale

rien `a valider (cr´eez/copiez des fichiers et utilisez "git add" pour les suivre)

$ echo "Hello world" > fichier.txt

$ git status Sur la branche master Validation initiale Fichiers non suivis:

(utilisez "git add <fichier>..." pour inclure dans ce qui sera valid´e) fichier.txt

aucune modification ajoutée à la validation mais des fichiers non suivis sont présents (utilisez "git add" pour les suivre)

Le fichierfichier1.txt est inconnu pour le d´epˆot git local.

(24)

Ajout de fichiers

1dadd 1dadd

édition

distant

Développeur

(25)

Ajout de fichiers

Utilisation degit add

$ git add fichier.txt

$ git status

Sur la branche master Validation initiale

Modifications qui seront valid´ees :

(utilisez "git rm --cached <fichier>..." pour d´esindexer) nouveau fichier: fichier.txt

Le fichierfichier1.txt est maintenant traqu´e/index´e.

(26)

Envoi de fichiers au d´ epˆ ot local

1ecommit

édition

distant

Développeur

(27)

Envoi de fichiers au d´ epˆ ot local (1)

Utilisation degit commit -m "Message"

$ git commit -m ’Version initiale du projet’

[master (commit racine) 0fed1bf] Version initiale du projet 1 file changed, 1 insertion(+)

create mode 100644 fichier.txt

Envoi des fichiers ajoutés à la liste des fichiers àcommitter

(28)

Envoi de fichiers au d´ epˆ ot local (2)

Tout fichier àcommitter doit d’abord être ajouté à la liste

$ echo "Hello world" >> fichier.txt

$ git commit -m ’Version modifi´ee 1 du projet’

Sur la branche master

Modifications qui ne seront pas valid´ees : modifi´e: fichier.txt

aucune modification ajoutée à la validation Utilisation de l’option-a(ou réalisation degit add)

$ git commit -a -m ’Version modifi´ee 1 du projet’

[master 6606d3d] Version modifi´ee 1 du projet 1 file changed, 1 insertion(+)

(29)

Historique des modifications

git log,git log --stat,git log -p

$ git log

commit 6606d3dd255f9c27447706a79f8d315346e0bd27 Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 13:59:40 2016 +0200 Version modifi´ee 1 du projet

commit 0fed1bfe1fbc4453e98954282caf5a16f219ee37 Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 13:41:18 2016 +0200 Version initiale du projet

(30)

Examen des modifications (1)

Affichage des modifications entre la copie de travail et la version indexée (pas forcément committée)

$ git diff

diff --git a/fichier.txt b/fichier.txt index 57bf5a7..7780f02 100644

--- a/fichier.txt +++ b/fichier.txt

@@ -1,2 +1,3 @@

Hello world Hello world +Hello world

(31)

Examen des modifications (2)

Affichage des modifications entre la version index´ee et la version committ´ee

$ git diff

$ git diff --cached

diff --git a/fichier.txt b/fichier.txt index 57bf5a7..7780f02 100644

--- a/fichier.txt +++ b/fichier.txt

@@ -1,2 +1,3 @@

Hello world Hello world +Hello world

(32)

D´ etail d’un commit

git show <HASHKEY>

$ git show 93f467b557

commit 93f467b5575964cd8fd266e105c065a1c214948e Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 15:00:19 2016 +0200 suppression fichier2

diff --git a/fichier2.txt b/fichier2.txt deleted file mode 100644

index e69de29..0000000

$ git show df0888da

commit df0888daa575bc283fa470a23c7ac01114066b46 Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 14:55:43 2016 +0200 Version modifi´ee 2 du projet diff --git a/fichier.txt b/fichier.txt index 95cb3b3..04d3bea 100644 --- a/fichier.txt

+++ b/fichier.txt

@@ -1,2 +1,3 @@

Hello world

(33)

Revenir en arri` ere (1)

Retirer un fichier de la liste des fichiers `acommitter (fichier index´e) avec git reset HEAD

$ git reset HEAD

Modifications non index´ees apr`es reset :

M fichier.txt

(34)

Revenir en arri` ere (2)

Suppression des modifications r´ealis´ees sur la copie de travail : git checkout -- FICHIER

$ git checkout -- fichier.txt

$ git status

rien `a valider, la copie de travail est propre

(35)

Revenir en arri` ere (3)

Restauration de la copie de travail à partir de la dernière version committée

$ git reset --hard

HEAD est maintenant `a 581337e Version modifi´ee 1 du projet

(36)

Suppression de la derni` ere version committ´ ee

Utilisation degit revert <HASHKEY>

$ cat fichier.txt Hello world Hello world 1 Hello world 4

$ git log

commit bd98a589871fbdc28f904630a5b27de38b0ff9fd Author: Thierry Hamon <hamon@limsi.fr>

commit 82c980fea261f79030ad888dabbca53d372d74cb Author: Thierry Hamon <hamon@limsi.fr>

commit 90f8ee3f9090f66c6dafe9817e41ac40cfd3eaf7 Author: Thierry Hamon <hamon@limsi.fr>

$ git revert bd98a

(37)

Suppression de la derni` ere version committ´ ee

$ cat fichier.txt Hello world Hello world 1

$ git log

commit a57b23231e32304067034e0d8dc78889bba6dfb3 Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 14:51:48 2016 +0200 Revert "Version modifi´ee 2 du projet"

This reverts commit bd98a589871fbdc28f904630a5b27de38b0ff9fd.

commit bd98a589871fbdc28f904630a5b27de38b0ff9fd Author: Thierry Hamon <hamon@limsi.fr>

commit 82c980fea261f79030ad888dabbca53d372d74cb Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 14:49:50 2016 +0200 Version modifi´ee 1 du projet ...

(38)

Suppression de la derni` ere version committ´ ee

...

commit 90f8ee3f9090f66c6dafe9817e41ac40cfd3eaf7 Author: Thierry Hamon <hamon@limsi.fr>

(39)

Suppression d’un fichier

Utilisation degit rm FICHIER

$ touch fichier2.txt

$ git add fichier2.txt

$ git commit -m "ajout fichier2"

[master f312e5c] ajout fichier2

1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 fichier2.txt

$ git rm fichier2.txt rm ’fichier2.txt’

$ ls fichier.txt

$ git status Sur la branche master

(utilisez "git reset HEAD <fichier>..." pour d´esindexer) supprim´e: fichier2.txt

$ git commit -m "suppression fichier2"

[master 93f467b] suppression fichier2

1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 fichier2.txt

$ ls fichier.txt

(40)

D´ eplacement/renommage d’un fichier (1)

Utilisation degit mv SOURCE CIBLE

$ git mv fichier.txt fichier1.txt

$ git status

(utilisez "git reset HEAD <fichier>..." pour d´esindexer) renomm´e: fichier.txt -> fichier1.txt

$ ls

DIR1/ fichier1.txt

$ git commit -m "renommage de fichier en fichier1"

[master 71f2f4d] renommage de fichier en fichier1 1 file changed, 0 insertions(+), 0 deletions(-) rename fichier.txt => fichier1.txt (100%)

$ ls

DIR1/ fichier1.txt

(41)

D´ eplacement/renommage d’un fichier (2)

$ git mv fichier1.txt DIR1

$ git status

(utilisez "git reset HEAD <fichier>..." pour d´esindexer) renomm´e: fichier1.txt -> DIR1/fichier1.txt

$ git commit -m "d´eplacement de fichier1 dans DIR1"

[master 7ace76a] d´eplacement de fichier1 dans DIR1 1 file changed, 0 insertions(+), 0 deletions(-) rename fichier1.txt => DIR1/fichier1.txt (100%)

$ ls -R .:

DIR1/

./DIR1:

fichier1.txt

(42)

Cr´ eation d’un r´ epertoire

NB : Pas d’ajout de répertoire vide dans un dépôt Git

$ mkdir DIR1

$ git add DIR1

$ git status

$ git commit -m "cr´eation r´epertoire"

$ git log

commit 93f467b5575964cd8fd266e105c065a1c214948e Author: Thierry Hamon <hamon@limsi.fr>

Date: Mon Sep 5 15:00:19 2016 +0200 suppression fichier2

....

(43)

Cr´ eation d’un r´ epertoire

Git ne g`ere que les fichiers (et indirectement les r´epertoires contenant des fichiers)

$ touch DIR1/.gitkeep

$ git add DIR1

$ git status

(utilisez "git reset HEAD <fichier>..." pour d´esindexer) nouveau fichier: DIR1/.gitkeep

$ git commit -m "cr´eation r´epertoire"

[master b364b1f] cr´eation r´epertoire

1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 DIR1/.gitkeep

(44)

Identification d’une version

Marquage d’une version avec une ´etiquette explicite : git tag -a ETIQUETTE

$ git tag -a RELEASE-1.0 -m "Premi`ere version potable du projet"

$ git tag -l RELEASE-1.0

Suppression de l’´etiquette avec l’option-d ETIQUETTE

$ git tag -d RELEASE-1.0

Étiquette ’RELEASE-1.0’ supprimée (elle était sur 824801a)

(45)

Gestion des branches

Possibilité de développement parallèle Création d’une branche :

$ git checkout -b branch1

Basculement sur la nouvelle branche ’branch1’

Liste des branches :

$ git branch

* branch1 master

S´election d’une branche :

$ git checkout master

Basculement sur la branche ’master’

(46)

Modification d’une branche

$ git branch

* branch1 master

$ echo "Bonjour tout le monde 1" >> DIR1/fichier1.txt

[branch1 47450ea] Version modifi´ee 5 du projet 1 file changed, 1 insertion(+)

$ more DIR1/fichier1.txt Hello world

Hello world 1 Hello world 4 Bonjour tout le monde 1

$ git checkout master

Basculement sur la branche ’master’

$ more DIR1/fichier1.txt Hello world

Hello world 1 Hello world 4

(47)

Fusion de branches

Utilisationgit merge BRANCHE_ORIGINE

Fusion des modifications deBRANCHE_ORIGINEavec la branche courante

thierry@brest:~/git-cgp$ git branch branch1

* master

thierry@brest:~/git-cgp$ git merge branch1 Mise `a jour b1360f3..04c6fc8

Fast-forward

DIR1/fichier1.txt | 1 + 1 file changed, 1 insertion(+)

thierry@brest:~/git-cgp$ more DIR1/fichier1.txt Hello world

Hello world 1 Hello world 4 Bonjour tout le monde 1

NB : Les modifications sont imm´ediatementcommit´ees

(48)

Utilisation d’un d´ epˆ ot distant

édition

distant

Développeur

(49)

Utilisation d’un d´ epˆ ot distant

2 clone

édition

distant

Développeur

(50)

Utilisation d’un d´ epˆ ot distant (1)

Récupération d’une copie locale du dépôt avec git clone ADRESSE_DEPOT

$ git clone thierry@brest:git-cgp Clonage dans ’git-cgp’...

thierry@brest’s password:

remote: Counting objects: 25, done.

remote: Compressing objects: 100% (15/15), done.

remote: Total 25 (delta 2), reused 0 (delta 0) R´eception d’objets: 100% (25/25), done.

R´esolution des deltas: 100% (2/2), done.

V´erification de la connectivit´e... fait.

$ cd git-cgp/

$ ls -R .:

DIR1/

./DIR1:

fichier1.txt

(51)

Utilisation d’un d´ epˆ ot distant

1ecommit

1dadd

édition

distant

Développeur

(52)

Utilisation d’un d´ epˆ ot distant

3 pull

édition

distant

Développeur

(53)

Utilisation d’un d´ epˆ ot distant

3bpush

édition

distant

Développeur

(54)

Utilisation d’un d´ epˆ ot distant (2)

R´ecup´erer/tirer des branches distantes : git pull

Fusion de la branche distante dans la branche courante puis commit du r´esultat

Attention : possibilité de conflit à résoudre puis committer le résultat

Machine 1 :

[master 81e872d] Version modifi´ee 6 du projet 1 file changed, 1 insertion(+)

$ git pull Already up to date.

$ git push

Counting objects: 7, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (3/3), done.

Writing objects: 100% (4/4), 383 bytes | 0 bytes/s, done.

Total 4 (delta 0), reused 0 (delta 0) To thierry@brest:git-cgp

Machine 2 :

$ git pull

remote: Counting objects: 7, done.

remote: Compressing objects: 100% (3/3), done.

remote: Total 4 (delta 0), reused 0 (delta 0) Unpacking objects: 100% (4/4), done.

Depuis brest:git-cgp

04c6fc8..81e872d master -> origin/master Mise `a jour 04c6fc8..81e872d

Fast-forward

(55)

Utilisation d’un d´ epˆ ot distant

4bpush 4apull

édition

distant

Développeur

(56)

Utilisation d’un d´ epˆ ot distant (3)

Envoyer/pousser une branche locale : git push Machine 2 :

[master 39256f5] Version modifi´ee 7 du projet 1 file changed, 1 insertion(+)

$ git push

Counting objects: 7, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (3/3), done.

Writing objects: 100% (4/4), 383 bytes | 0 bytes/s, done.

Total 4 (delta 0), reused 0 (delta 0) To thierry@brest:git-cgp

eee01f8..39256f5 master -> master

NB : Modification du dépôt sur la machine 1 pour être une simple dépôt (pas de possibilité de modification en locale)

(57)

Identification de l’auteur des commits

git blame -- FICHIER

$ git blame -- DIR1/fichier1.txt

^5f6bc29 fichier.txt (Thierry Hamon 2016-09-05 18:12:10 +0200 1) Hello world 1a1d0990 fichier.txt (Thierry Hamon 2016-09-05 18:12:10 +0200 2) Hello world 1 785210f2 fichier.txt (Thierry Hamon 2016-09-05 18:12:10 +0200 3) Hello world 4 eee01f87 DIR1/fichier1.txt (Thierry Hamon 2016-09-05 18:12:10 +0200 4) Bonjour tout le monde 1 39256f53 DIR1/fichier1.txt (Thierry Hamon 2016-09-05 18:12:53 +0200 5) Bonjour tout le monde 3

(58)

R´ esolution des conflits

Conflit : incompatibilit´e de modifications `a fusionner Processus :

Marqueurs de conflits associ´es aux fichiers sur lesquels portent les conflits

Pas d’ajout à l’index (liste des fichiers à committer) Résolution du conflit par le développeur

Ajouter des fichiers `a l’index Committer le r´esultat

(59)

Conclusion

Git :

Outil complexe mais puissant pour la gestion de version de fichiers (code ou autre)

Très souvent utilisé en milieu professionnel Nombreuses autres possibilités non présentées ici

(60)

Sources des transparents

Matthieu Herrb (LAAS)

https://git-scm.com/book/en/v2 Christopher Simpkins (Georgia Tech) Anthony Baire (Rennes 1/IRISA)

http://ben-denham.github.io/git-advanced/pages/

git-cheatsheet.html

(61)

(62)

Subversion (SVN)

http://subversion.apache.org/

Syst`eme de gestion de version permettant le d´eveloppement collaboratif

le partage de fichiers et de répertoire dans un dépôt la numérotation des version des fichiers et répertoires la récupération des anciennes versions des fichiers la gestion des conflits sur un fichier

la diffusion des mises à jour du dépôt

Centralisation du dépôt (modèle client-serveur) Disponible indépendamment de tout IDE

mais accessible sous forme d’un module dans Eclipse Commande utilisateur (client) : svn

Aide : svn helpousvn help commande

(63)

Fonctionnalit´ es de Subversion

Syst`eme optimiste

(mais possibilité de verrouillage si c’est vraiment nécessaire) Définition de méta-données (informations associées) sur les fichiers et les répertoires

Révision des fichiers, répertoires et méta-données

Manipulation de l’arborescence du dépôt (ajout, suppression et déplacement des fichiers et répertoires)

Opérations de révision (commit/update/import) regroupées sur plusieurs fichiers

atomiques (travail au niveau de la ligne et non du fichier) Gestion des branches et des distributions

(64)

Caract´ eristiques techniques

Stockage diff´erentiel des fichiers

Seules les modifications par rapport à la révision précédente sont enregistrées

Gestion particuli`ere des fichiers binaires

Fonctionnementoffline pour certaines op´erations :

Etat des fichiers de la copie locale (svn status), diff´erences entre deux r´evisions (svn diff), annulation des modifications locales (svn revert)

Utilisation des informations se trouvant dans les r´epertoires .svn

Diff´erents protocoles de communication (SGF, HTTP, SVN, SVN+SSH)

(65)

Architecture SVN

svn commit svn commit

svn update svn update

svn checkout svn checkout

modification différence

...

édition modification

différence ...

édition

Développeur (commande svn) Copie de travail

Développeur (commande svn) Copie de travail svn import

Arborescence initiale

Dépot SVN

Administrateur (commande svnadmin)

(66)

Cr´ eation du d´ epˆ ot

En tant qu’administrateur de Subversion Utilisation de la commande svnadmin

Création du dépôt : svnadmin create <depot>

Aide pour svadmin : svnadmin help

(67)

Sauvegarde/restauration du d´ epˆ ot

svnadmin dump <depot> > fichier

Sauvegarde l’ensemble du dépôt : fichiers, répertoires, méta-données, etc.

Le fichier en sortie permet la restauration du d´epˆot svnadmin load <depot> < fichier

Restauration du dépôt à partir d’un fichier sauvegardé

(68)

Cr´ eation d’un projet

Importation d’une arborescence initiale dans le dépôt Arborescence UNIX contenant et organisation les fichiers à ajouter au dépôt SVN

Organisation sur le dépôt, dans le répertoire contenant le projet :

un répertoiretrunkcontenant la branche principale où sera importée l’arborescence principale

un répertoirebranchesoù seront stockés plus tard les arborescences secondaires

un répertoiretags où seront stockées les distributions Remarques :

Organisation purement conventionnelle

(69)

Quels fichiers placer sur le d´ epˆ ot ?

Tous les fichiers modifi´es par les d´eveloppeurs : Fichiers sources

s’assurer qu’il est possible de reconstituer le produit `a partir de ces fichiers

Fichiers de documentation et de construction du logiciel (makefile, etc.)

Ne surtout pas mettre : les fichiers temporaires

les fichiers compilés ou générés à partir des fichiers sources (fichiers objets, exécutables, librairies, archives)

(70)

Importation initiale

svn import -m "Message" <arborescence initiale> <depot>

Intégration de l’arborescence initiale (fichiers et répertoire dans le dépôt)

Tous les fichiers et répertoires sont gérés sous SVN Création de la version 1 du dépôt

Option -m: spécification d’un message associé à l’opération effectuée

NB : sans l’option -m, un éditeur par défaut est exécuté pour rédiger un message (l’éditeur est défini dans la variable d’environnementSVNEDITOR.

Remarque importante : supprimer ou ne plus utiliser l’arborescence

(71)

Importation initiale (1)

1 svn import

Dépot SVN

(72)

Importation initiale (2)

1 svn import

Dépot SVN

(73)

R´ ecup´ eration d’une copie locale

svn checkout <chemin du depot>

Création d’une copie locale du dépôt

Chaque développeur doit effectuer l’opération avant de travailler sur les sources (édition, modification, ajout, suppression, etc.)

Raccourci pour checkout: co svn co <chemin du depot>

(74)

R´ ecup´ eration de la copie locale

2

2 svn checkout svn checkout

...

édition

Dépot SVN

(75)

Mise ` a jour de la copie locale

svn update

(en étant présent dans un répertoire sous SVN)

Récupération/synchronisation de la copie locale avec les dernières modifications sur le dépôt

Fusionne les données si nécessaire En cas d’échec de la fusion,

un conflit est identifi´e

l’utilisateur doit choisir entre les modifications sur le d´epˆot et ses propres modifications

La mise à jour peut n’être demandée pour qu’une partie de l’arborescence

Raccourci pour update: up svn up

(76)

Mise ` a jour de la copie locale

3 3

svn update svn update

...

édition

Dépot SVN

(77)

Mise ` a jour du d´ epˆ ot

svn commit -m "Message"

Mise à jour du dépôt avec les modifications locales

Possibilité d’échec si le dépôt a été mis à jour depuis le dernier svn update

Il est n´ecessaire de faire une nouvelle mise `a jour

Option -m: spécification d’un message associé à l’opération effectuée (idemsvn import)

(78)

Mise ` a jour du d´ epˆ ot

4

4 svn commit

svn commit

...

édition

Dépot SVN

(79)

Manipulation de l’arborescence

... sous SVN

(en étant présent dans un répertoire sous SVN) Ajout de fichier : svn add <fichier>

Ajout de r´epertoire : svn mkdir <fichier>

D´eplacement/renommage de fichier : svn mv <fichier> <nouveau fichier Suppression de fichier ou de r´epertoire : svn rm <fichier>ousvn delete <fichier>

NB : Effectuer uncommitaprès ces opérations pour qu’elles soient effectives sur le dépôt

Attention: ne pas utiliser de commandes UNIX pour réaliser ces opérations. SVN prend tout en charge (même sur la copie locale).

(80)

R´ esolution d’un conflit

Apparition possible d’un conflit lors d’un commitou d’un update

le statut est àCpour les fichiers où un conflit est apparu Résolution du conflit :

Editer du fichier local

les zones en conflit sont marqu´ees par

>>>>>>>>>>>>>>>

et

<<<<<<<<<<<<<<<

Faire un choix dans les modifications `a conserver et sauvegarder le fichier

Indiquer `a SVN que le conflit est r´esolu :

(81)

R´ esolution d’un conflit

Remarque

SVN propose la résolution des conflits (l’édition des fichiers où se trouve un conflit) lors d’un commit

les modifications locales peuvent ˆetre abandonn´ees : svn revert <fichier>

(retour à la dernière mise à jour locale –COMMITTED)

(82)

Examen du d´ epˆ ot

Informations sur le d´epˆot : svn info

Liste des fichiers sur le d´epˆot : svn list (svn ls) Statut des fichiers : svn status

Différences entre la copie locale et le dépôt : svn diff NB : Il est possible de mentionner des numéros de version : svn diff -r 11:20 fichier.txt

Visualisation des logs : svn log

(83)

R´ evisions

num´eros de version

R´ealis´ees par groupe d’actions (modification de fichiers, manipulation de l’arborescence, etc.)

Numéro de version : entier croissant à chaque commit Un numéro de version par fichier

Il existe des raccourcis :

HEAD: dernier numéro de version sur le dépôt

BASE: dernier num´ero de version dans la copie locale (avant modification)

COMMITTED: numéro de version pour laquelle une modification a été placée sur le dépôt (COMMITTED<=BASE)

PREV: num´ero de version juste avantCOMMITTED (PREV =COMMITTED−1)

(84)

Statut des fichiers

svn status

A: Il est prévu d’ajouter le fichier lors du prochaincommit D: Il est prévu de supprimer le fichier lors du prochaincommit U: Le fichier vient d’être mis à jour

M: Le fichier de la copie locale a subi des modifications (par rapport au dernier update)

C: Le fichier contient des conflits (apparus lors de la dernier mise à jour/fusion avec la version sur le dépôt)

G: Le fichier n’est pas intégré au dépôt

?: Le fichier n’est pas intégré au dépôt

!: Le fichier est incompl`ete ou absent

X: Le fichier n’est pas int´egr´e dans la copie de travail

(85)

Substitution de mots-cl´ es

Insertion dans les fichiers d’informations relatives aux r´evisions (num´eros de version, auteur, date, etc.)

Substitution lors des commit

Activation de la propriété de substitution des mots-clés : svn propset svn:keywords "Id" fichier.txt Utilisation des mots-clés dans les fichiers ($Id$) Mots-clés disponibles :

Date(ouLastChangedDate) : date de la derni`ere r´evision sur le fichier

Revision:derni`ere r´evision sur le fichier

Author: Auteur de la dernière révision sur le fichier HeadURL: URL du fichier sur le dépôt

(86)

Cr´ eation d’une distribution

Copie d’une r´evision dans le r´epertoiretags

svn copy <depot>/trunk <depot>/tags/<release>

release est le nom de la distribution (par exemple version-1.2)

ATTENTION : les modifications restent possibles sur la distribution (`a ´eviter absolument !)

R´ecup´eration de la distribution : svn co <depot>/tags/<release>

Cr´eation d’une copie non-versionn´ee de la distribution : svn export <depot>/tags/<release>

(87)

Cr´ eation d’un patch

Objectif : transmettre des modifications en dehors du d´epˆot SVN

Modification de sources déjà publiées

Création du patch : génération d’un fichier des différences entre deux révisions du dépôt (fichier ou arborescence) Exemple sur un fichier :

svn diff -r 12:13 fichier > fichier-r12-13.patch Application du patch sur une arborescence quelconque : (la o`u se trouve le fichier `apatcher)

patch < fichier-r12-13.patch

(88)

Cr´ eation d’une branche

Objectif : Réaliser des développements ou des corrections en parallèle au tronc (trunk)

Branche : copie d’une r´evision de l’arborescence principale (trunk)

svn copy <depot>/trunk <depot>/branches/<feature>

feature est l’identifiant de la branche cr´e´ee (par exemple, ma-branche)

Utilisation :

svn co <depot>/branches/<feature>

Puis travail sur la branche de la même manière que le tronc Possibilité de fusion des modifications de la branche dans le

(89)

Fusion des branches

Rapatriement des modifications dans le tronc (ou dans un autre branche) et inversement

svn merge -rRi <depot>/branches/<feature>

Application de la r´evision Ri de la branche feature`a la copie locale courante (tronc ou autre branche)

NB : il est fortement conseiller de commencer par examiner les diff´erences :

svn diff -rRi <depot>/branches/<feature>

(90)

Conseils et bonnes pratiques

Effectuer des mises à jour (commit) régulières de la copie locale (limite les possibilités de conflits)

Préférer les mises à jour (update) de l’ensemble de l’arborescence Toujours réaliser unupdateavant uncommit

Réaliser descommitcorrespondant à un ensemble cohérent de modifications

Toujours compiler et tester les sources avant de réaliser un commit Vérifier que les fusions sont réalisées correctement

Ne pas prendre à la légère les conflits

Ne pas utiliser les commandes syst`eme pour les modifications d’arborescence (utilisersvn add|mv|rm)

Documenter les commits avec des messages explicites (accessibles ensuite avecsvn log)

Les messages de commit peuvent être envoyés automatiquement à toutes

(91)

Sources des transparents

Georges-Etienne Legendre, F´elix-Antoine Bourbonnais Jean-Fran¸cois Mari, IUT Charlemagne, dpt. informatique Didier DONSEZ, Universit´e Joseph Fourier - Grenoble 1, PolyTech’Grenoble LIG/ADELE

Nicolas Hernandez, IUT de Nantes - D´epartement Informatique