Documentation
Handbook - Subversion et gestion de versions
Introduction à Subversion
Subversion est un système de gestion de versions, on commence à crée un dépôt qui va servir à stocker un projet. Une fois ce dépôt créé et rempli des fichiers du projet, chaque personne y ayant accès peut charger le contenu sur son disque local. Ensuite on peut effectuer des opérations tel que modifier des fichiers, en effacer, compiler des sources, sans affecter le contenu du dépôt original.
Pour connaître les commandes disponibles pour svn.
$ svn help
Installer subversion
Subversion est disponible sous forme de paquet fornit par les différentes distributions GNU/Linux tel que Debian.
Install sous Debian
Pour installer subversion et quelques outils associés:
# aptitude install subversion subversion-tools
Pour utiliser subversion via le web, il existe un module apache2 qui permet d'utiliser subversion. Il y a aussi des logiciles pour voir les dépôts en ligne tels que ViewSVN et websvn, et quelques logiciles de gestion en mode graphiques tels que esvn et rapidsvn:
# aptitude install esvn Pour le module d'Apache: # aptitude install libapache2-svn
Le module est chargés dans /etc/apache2/mods-enabled/dav_svn.conf.
Il faut modifier la configuration du module de subversion pour qu'il
corresponde à vos besoin.
Install sous Gentoo
# emerge svn
Cycle de Subversion
- svnadmin create - Créer un dépôt.
- svn import - Importer un projet pour gestion dans un dépôt.
- svn checkout - Récupérer la copie d'un projet depuis un dépôt.
- svn add, svn copy, svn move, svn delete - Modifier & créer le contenu du projet.
- svn status - Consulter les modifications.
- svn commit - Soumettre des modifications.
- svn log - Afficher des logs de subversion.
- svn update - Mettre à jour son dépôt local.
svnadmin create
Pour créer un dépôt sur une machine:
$ svnadmin create dossier/sousDossier/depot
import
Pour importer un projet dans le dépôt avec l'option -m et un
premier message pour les logs du projet:
$ svn import /mon/projects/ file:///local/projects/name -m "Premier import"
svn checkout
Les protocoles disponnibles avec Subversion:
file:// - Pour un dépôt sur un disque local
svn:// - Pour un dépôt distant avec un serveur Subversion dont
l'authentification est gérée par Subversion.
svn ssh:// - Pour un dépôt distant avec un serveur Subversion dont
l'authentification est gérée par ssh.
http:// - Pour un dépôt distant avec un serveur web.
Pour récupérer la base, d'un projet du dépôt local, dans un dossier du
système. La commande cd permet de se placer dans le répertoire
racine de l'utilisateur courant:
$ cd ~ $ mkdir svn-projet $ svn checkout file:///dossier/sousDossier/depot/ svn-projet
Checkout avec svn ssh.
$ svn checkout svn ssh://machine.org/dossier/depot monSVN/projet
svn commit - Soumettre des modifications
Pour soumettre des modifications et les ajouter à la base du projet. Il faut
ce placer à la racine de la copie du projet en local avec cd.
Sans l'option -m cette commande ouvrira l'éditeur vi pour que
vous écriviez le message du commit:
$ svn commit -m "Message pour les logs"
