Installation de Subversion sur Windows

Eric Reboisson

Subversion (parfois abrégé SVN) est un logiciel informatique de contrôle de version. Il reprend les principes de CVS, mais en l'améliorant ( ex. : copie et renommage de fichiers avec conservation de l'historique, commit atomiques, etc.).

- Titre : Installation de Subversion sur Windows

- Auteur : Eric Reboisson

- Parution : 21 janvier 2006

- Mise à jour : 5 juin 2020

- Licence : Copyright ® 2006 Eric Reboisson. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Téléchargement des outils

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

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

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

- V. Paramétrer le serveur comme service

- VI. Installation de TortoiseSVN

- VII. Subversion au travers d'un réseau

- VIII. Conclusion

- IX. Remerciements

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
À 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.
À 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)

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) :

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 »

Ouvrir le répertoire d:\svn_repos\conf (créé juste avant par la commande svnadmin), et éditer les deux 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

### 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 »

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

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

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 »

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.

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

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 »

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.

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/

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épôt (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).

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.

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

Contenu du fichier toto.txt

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'une icône particulière (un +) apparaît sur l'icône du fichier.

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 ».

Saisir un commentaire et cliquer sur OK

Cliquer sur OK

VII - 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.