I. Téléchargement des outils

  • Aller sur Télécharger Subversion et télécharger le plus récent svn-x.y.z-setup.exe
    A la rédaction de cet article, la dernière version est svn-1.3.0-setup.exe

  • Aller sur Télécharger le service Windows et télécharger SVNService.zip (L'archive peut également être téléchargée ici )

  • Aller sur Télécharger TORTOISESVN et télécharger l'installeur le plus récent.
    A la rédaction de cet article, la dernière version est TortoiseSVN-1.3.0.5416-svn-1.3.0.msi

II. Installation du serveur et du client en ligne de commande

Lancer svn-x.y.z-setup.exe et suivre simplement les étapes d'installation ( Note : Pour cet article Subversion est installé dans le répertoire D:\Programmes\SVN )

Image non disponible
Image non disponible

Ouvrir ensuite le "Panneau de configuration" > "Système", aller sur l'onglet "Avancé", et cliquer sur le bouton "Variables d'environnement"

Cliquer sur le bouton "Nouveau" dans la zone des variables système, saisir SVN_EDITOR dans "Nom de la variable", et le chemin d'un éditeur de texte comme valeur de cette variable (ex: C:\WINDOWS\notepad.exe)

Image non disponible

III. Création du repository et configuration des accès

Créer un répertoire svn_repos quelque part sur votre disque dur.

Ce répertoire contiendra le référentiel de fichiers de Subversion.

Pour cet article je crée le répertoire du repository dans d:\svn_repos

Ouvrir une fenêtre de commande DOS et taper svnadmin create "d:\svn_repos"

Image non disponible

Ouvrir le répertoire d:\svn_repos\conf ( créé juste avant par la commande svnadmin ), et éditer les 2 fichiers de configuration suivants :

  • Ouvrir le fichier svnserve.conf dans un éditeur de texte, décommenter les lignes [general] , anon-access = read, auth-access = write, et password-db = passwd ( pour décommenter, supprimer le # et l'espace ). Sauvegarder et fermer l'éditeur.

  • Ouvrir le fichier passwd dans un éditeur de texte, décommenter la ligne [users] , et ajouter le username et le password que vous voulez utiliser pour vous connecter au serveur Subversion. Sauvegarder et fermer l'éditeur.

Contenu du fichier passwd
Sélectionnez

			### This file is an example password file for svnserve.
			### Its format is similar to that of svnserve.conf. As shown in the
			### example below it contains one section labelled [users].
			### The name and password for each user follow, one account per line.
			
			[users]
			# harry = harryssecret
			# sally = sallyssecret
			toto = blague
			

IV. Démarrer le serveur manuellement, et créer un projet

Dans la fenêtre de commande DOS ( Vous ne l'avez pas fermée au moins ? sinon en ouvrir une nouvelle ) taper svnserve --daemon --root "d:\svn_repos"

Image non disponible

Ouvrir une seconde fenêtre de commande DOS, et taper svn mkdir svn://localhost/monprojet

Image non disponible

L'éditeur de texte que vous avez paramétré en variable d'environnement s'ouvrira alors sur un fichier avec du texte déjà présent.

Taper un commentaire, par exemple "Création de mon projet" au début du fichier ( avant la ligne commençant par "--" ). Sauvegarder le fichier et fermer l'éditeur.

Contenu du fichier
Sélectionnez

			Création de mon projet
			--Cette ligne, et les suivantes ci-dessous, seront ignorées--
			
			A    svn://localhost/monprojet
		

Dans la fenêtre de commande DOS de création, si votre login Subversion est le même que pour votre session Windows, alors taper votre mot de passe dans la fenêtre de commande ( celui que vous avez saisi dans le fichier passwd ), et taper la touche "Entrée".

Si votre login Subversion est différent de votre login Windows, alors taper la touche "Entrée" à l'invite du password dans la fenêtre de commande, SUBVERSION vous demandera alors le login et le mot de passe que vous avez saisi dans le fichier passwd.

Subversion vous indiquera alors "Révision 1 propagée"

Image non disponible

Félicitations! Vous venez de charger une première version de fichier.

Il est courant d'avoir des sous-répertoires /trunk , /branches, et /tags pour chaque projet.

Dans la fenêtre de commande DOS précédente taper svn mkdir svn://localhost/monprojet/trunk et comme précédemment saisir un commentaire dans le fichier ouvert, sauvegarder et fermer l'éditeur.

A noter qu'après avoir saisi votre commentaire, Subversion ne vous redemande pas le login/password.

Image non disponible

V. Paramétrer le serveur comme service

Retourner dans la fenêtre de commande DOS qui exécute svnserve. Taper Ctrl+C pour l'arrêter et fermer la fenêtre.

Ouvrir l'archive SVNService.zip téléchargée précédemment.

Extraire SVNService.exe ( et les autres fichiers de l'archive ) dans le répertoire bin de Subversion ( Dans cet article : d:\Programmes\SVN\bin).

Il est important que le contenu de l'archive soit au même endroit que l'exécutable svnserve.exe du logiciel Subversion. Ouvrir une fenêtre de commande DOS, et taper svnservice -install --daemon --root "d:\svn_repos"

Image non disponible

Ouvrir ensuite le "Panneau de configuration" > "Outils d'administration" > "Services", double-cliquer le service SVNService, et changer le type de démarrage de "Manuel" en "Automatique", appliquer et cliquer OK.

Image non disponible

Maintenant Subversion se lancera à chaque démarrage de Windows.

Il faut cependant démarrer le service SVNService manuellement dans notre cas ( en le sélectionnant dans la liste des services, et en cliquant Démarrer via le menu contextuel )

Retourner à la fenêtre de commande DOS, et taper svn ls svn://localhost/

Image non disponible

La liste de tous les fichiers de la racine du repository apparaît.

Si tout s'est bien passé auparavant et que votre serveur Subversion fonctionne, vous devriez voir apparaître: monprojet/

Pour l'installation, il faut maintenant utiliser le fichier install.bat (contenu dans SVNService.zip) avec MS .NET Framework 1.1 en prérequis. Pour la configuration, il faut configurer le fichier SVNService.exe.config (fichier au format XML) pour indiquer le chemin de svnserve (SVNBinaryPath) ainsi que pour localiser le dépot (RepositoryRoot).

VI. Installation de TortoiseSVN

TortoiseSVN est un logiciel qui permet d'interagir avec Subversion dans l'explorateur de fichiers Windows.

Lancer l'installeur de TortoiseSVN téléchargé précédemment, choisir d'installer toutes les options sur le disque dur et suivre les étapes d'installation ( Note : Pour cet article TortoiseSVN est installé dans le répertoire D:\Programmes\TortoiseSVN ).

Image non disponible
Image non disponible

Créer ensuite un répertoire "monprojet" quelque part sur votre disque dur ( Dans cet article d:\monprojet ).

Cliquer droit quelque part à l'intérieur du répertoire et sélectionner "SVN Checkout..."

Taper svn://localhost/monprojet/trunk/ comme URL du repository et cliquer sur le bouton OK puis sur le bouton OK de la fenêtre suivante.

Image non disponible

Créer maintenant un fichier toto.txt dans ce répertoire.

Contenu du fichier toto.txt
Sélectionnez

			Juste un test de contenu
			

Cliquer droit sur le fichier et sélectionner TortoiseSVN > Add puis valider en cliquant OK sur la fenêtre suivante.

Noter qu'un icône particulière ( un + )apparaît sur l'icône du fichier.

Image non disponible

Le fichier n'est pas encore chargé dans Subversion, pour cela il faudra faire un commit en cliquant droit sur le fichier toto.txt et sélectionner "SVN Commit".

Image non disponible

Saisir un commentaire et cliquer sur OK

Image non disponible

Cliquer sur OK

VI. Subversion au travers d'un réseau

Sur un autre PC de votre réseau, installer TortoiseSVN ( voir précédemment )

Créer un répertoire monprojet sur d: et faire un "SVN Checkout..." à l'intérieur de ce répertoire.

Quand vous spécifiez l'URL du repository, utilisez la même URL qu'auparavant, mais remplacez "localhost" avec le nom de l'ordinateur sur lequel s'exécute le service Subversion ( Dans mon cas, l'URL du repository est svn://portable/monprojet/trunk/ )

Vous verrez alors apparaître le fichier toto.txt avec le contenu précédemment créé.

VIII. Conclusion

Voilà vous avez maintenant un serveur Subversion installé qui pourra vous permettre :

  • De gérer les sources d'un projet au travers d'une équipe
  • De gérer des versions de documents ( CV, spécifications, etc....)
  • Et plus encore...

Maintenant il existe d'autres outils de versionning et voici un lien qui vous permettra de comparer:

Comparaison des outils de versionning

IX. Remerciements

Un grand merci à COGAN pour la relecture et les corrections sur cet article.