Mini howto de Subversion (SVN) Frederic Ollivier aka froumi

Mini howto de Subversion (SVN)
Frederic Ollivier aka froumi
Informations utiles et conventions typographiques
Afin de faciliter la compréhension des techniques décrites, j'ai adopté les conventions
typographiques suivantes :
les lignes de commande commençant par #, comme par exemple :
#apt-get update
doivent être utilisé en tant que super-utilisateur root.
les lignes de commande commençant par $, comme par exemple :
#touch toto
doivent être utilisé en tant que utilisateur standard.
Un '\' en fin d'une ligne de commande indique que celle-ci ce poursuit avec la ligne suivante.
'~' indique le racine du répertoire personnel.
Introduction
Subversion est un gestionnaire de version de projet, il est
le descendant et successeur de cvs. Subversion a hérité des
commandes de son ancêtre mais avec en plus, beaucoup plus de
possibilité de configuration, en effet l'administrateur du serveur
a plus de possibilité sur la gestion des droits écriture/lecture
sur les différentes partis d'un dépôt. Au niveau de la sécurité,
la liaison avec le dépôt peut se faire via une connexion crypté de
type https.
Installation de Subversion :
Le site officiel de subversion est :
http://subversion.tigris.org.
Ce mini-howto étant plutôt orienté pour une utilisation avec
le projet slis-debian (aka Slis 4.0 ). Je ne parlais que de son
installation sur une distribution Linux Debian stable.
La version 1.0.0 Subversion n'étant disponible que très
récemment, elle n'est pas disponible dans la version officielle de
la Debian 3.0 Woody. Par contre, Subversion peut « Backporté » à
partir du site :
http://www.backports.org/debian/dists/stable/subversion/
Pour l'installation, il suffit donc, d'éditer en tant que 'root'
le fichier /etc/apt/sources.list et de rajouter la ligne :
deb http://www.backports.org/debian stable subversion
Ensuite :
#apt-get update
(pour mettre à jour la base de données des logiciels disponible
pour apt)
#apt-get install subversion -y
(installation du backportage subversion)
Utilisation locale :
Imaginons que vous avez un projet slis avec comme arborescence :
~/slis (répertoire du projet d'origine)
~/slis/essai.pl (un fichier)
~/slis/essai (un autre ...)
Nous allons créer un nouveau dépôt de SVN:
$ cd ~
(retour à la racine de son répertoire personnel )
$ svnadmin create svn
(création du répertoire)
Mettre des données dans le nouveau dépôt
répertoire existant slis avec des fichiers :
en
utilisant
le
$ svn mkdir file:///home/froumi/svn/slis -m 'Creation du projet Slis'
$ svn import /home/froumi/slis file:///home/froumi/svn slis \
-m 'Import initial du projet Slis'
Le texte qui suit l'option '-m' est inséré dans le log.
Pour commencer à travailler avec le projet slis, nous devons
vérifier (checkout) les dernières version de fichier dans un
nouveau répertoire.
$ svn checkout file:///home/froumi/svn/slis ~/slis-src
Pour faire 'Commit' (ce qui peut être traduit par 'changement')
d'un fichier utiliser ce qui suit. Il faut savoir aussi que SVN
garde une entrée dans ses logs à chaque fois que nous faisons un
Commit.
$ svn commit *.pl \
-m "Commit seulement les fichiers perl avec l'extension .pl"
ou bien par exemple :
$ svn commit *.pl slis/debian \
-m "Sauvegarde tout les fichiers .pl dans le répertoire courant et tout ce qui
se trouve dans le répertoire slis/debian "
ou aussi :
$ svn commit -m "Chargement de tout les fichiers qui ont changer depuis le
dernier commit"
Utilisation distante :
Le projet slis-debian se trouve donc sur le serveur subversion de
l'académie de Grenoble :
https://svn.ac-grenoble.fr/
en vous connectant à cette URL avec un navigateur quelconque vous
pourrez explorer l'arborescence des différents dépôts.
L'utilisation
en
ligne
de
commande
nécessite
un
compte
d'utilisateur que vous devrez demander à l'administrateur Monsieur
Bruno Bzeznik :
[email protected]
Je prendrais dans les exemples suivant :
Comme nom d'utilisateur :
froumi
et comme mot de passe :
wawa
;)
Nous allons récupérer un dépôt de SVN à jour :
$ cd ~
(retour à la racine de son répertoire personnel)
L'utilisation de svn à distance ressemble un peu à l'utilisation
locale précédente.
$ svn checkout https://svn.ac-grenoble.fr/svn/slis ~/slis-projet –username
froumi –password wawa
(récupération du dépôt sur la machine locale, ici on le mets par
exemple dans le répertoire local nommé slis-project)