Pour l'installer donc, rien de plus simple. Il suffit de se rendre dans Help > Install new softwares. Puis, cliquez sur Add afin d'ajouter l'adresse à laquelle nous allons récupérer Subclipse, à savoir http://subclipse.tigris.org/update_1.6.x.

Validez, et sélectionnez dans Work with le nouveau dépôt inséré. Une arborescence apparaîtra alors. Sélectionnez les packages désirés. Pour ma part, n'étant pas très sûr, j'ai sélectionné ceux-ci :

Il ne vous reste plus qu'à faire Next régulièrement et à passer outre les différents avertissements. Enfin, on redémarre Eclipse comme conseillé, et c'est parti !

A présent, pour faire un check out de votre projet, faîtes un clic-droit dans le navigateur de fichiers, puis Import. Sélectionnez alors SVN > Checkout projects from SVN. Puis, Create a new repository location. Enfin, entrez l'URL de votre dépôt. Il ne vous reste plus qu'à configurer votre projet.

Toutes les autres actions SVN seront présente dans le menu contextuel Team. A vous de coder maintenant ! :)

J'ai donc commencé par récupérer le dépôt de mon blog :

$ svn co svn+ssh://svn.monserveur.com/mondepot/

Or, Ubuntu refuse de me faire accéder au dépôt, sous prétexte que :

svn: Ce client est trop vieux pour travailler sur la copie de travail '.' ; récupérer une version plus réçente du client

Fichtre. Je savais que je n'avais pas la dernière version de ma distribution favorite, mais je ne m'attendais pas du tout à cela. Une recherche sur Internet plus tard me donne la solution : il suffit de rajouter une nouvelle source à notre liste apt-get. On s'y attelle donc :

# echo deb http://ppa.launchpad.net/clazzes.org/ubuntu hardy main >> /etc/apt-get/sources.list

On met ensuite à jour notre arbre apt-get, et on réinstalle Subversion :

# apt-get update
# apt-get install subversion

Il est possible qu'un avertissement apparaîsse, comme quoi ce n'est pas un dépôt officiel. Il suffit de confirmer, et vous aurez la dernière version de Subversion, et serez donc enfin capable de faire votre check-out.

Logo Subversion

Pour une raison ou pour une autre, on peut parfois être amené à récupérer la totalité d'un dépôt .svn sans passser par la commande export. Notre ami Korben a publié un article dernièrement concernant la suppression des dossiers .svn sous Linux.

Ce que je vous propose ici est la même manipulation, mais sous Windows. Certes, des petits malins pourraient se dire qu'il suffit d'installer CygWin (un environnement Linux pour Windows), mais installer tout cela pour uniquement une commande, qui se réalise très bien en Batch... :)

Voici donc la très précieuse commande :

for /r repository %f in (.svn) do rd /S /Q "%f"

Quelques explications ? Allez, je me lance ! Tout d'abord, on effectue une boucle for de manière récursive, lui demandant de mettre dans la variable %f tous les fichiers rencontrés qui satisfont la condition .svn. Ensuite, on supprime le répertoire correspondant (rd, pour remove directory). On veut supprimer le répertoire lui-même ainsi que tous ses dossiers et sous-dossiers (option /s), et ne pas demander de confirmation à l'utilisateur (/q).

Bref, rien de bien compliqué, à condition toutefois de connaître la commande vitale pour les batchs, équivalent du man Linux : commande /?.

Le Batch Windows est souvent obscurci par les fichiers Shell Linux. Mais, il permet de faire cependant des choses intéressantes. :)

Tout d'abord, sur l'ancien serveur, nous allons faire une sauvegarde de notre dépôt, grâce à la commande dump de svnadmin.

# svnadmin dump /var/svn/myProject/ > ~/myProject.svndump

Vous obtiendrez donc une archive contenant tous les fichiers (incluant les .svn de votre projet, le tout trié par commits successifs.

Nous allons à présent transférer ce fichier, présent sur notre ancien serveur, sur notre nouveau serveur. Pour cela, deux méthodes. Soit on place l'archive dans un répertoire accessible par Apache et on utilise un wget, soit on utilise le protocole de copie sécurisée accessible avec l'utilitaire scp.

Cette première solution étant des plus faibles niveau sécurité (je pense notamment aux personnes qui n'hésitent pas à placer leurs fichiers SQL directement sur leur site Web... Il ne vaut mieux pas oublier de l'enlever, sous peine de voir les emails de ses 12.000 membres publiés sur le Net), nous opterons pour la seconde. Sur l'ancien serveur donc :

# scp ~/.myProject.svndump 91.243.11.27:

On suppose ici que l'adresse de notre nouveau serveur est 91.243.11.27 (adresse prise complètement au hasard). Attention à ne pas oublier les deux points à la fin ! Sans cela, le transfert ne s'effectuera pas.

Une fois ces étapes achevées, allons sur le nouveau serveur, et créeons le nouveau dépôt qui permettra de prolonger l'existence de l'ancien :

# svnadmin create /var/svn/myNewProject

Et enfin, on charge le contenu de notre sauvegarde dans ce nouveau dépôt.

# svnadmin load /var/svn/myNewProject < ~/myProject.svndump

Et voilà. Il ne vous reste plus qu'à faire un nouveau check out ou éventuellement un relocate pour continuer à travailler, de manière presque transparente, sur votre dépôt.

Tortoise SVN

Initialement destiné à mes associés, j'ai décidé de vous faire partager ce petit tutoriel sur l'utilisation de Tortoise, un logiciel qui vous permettra de gérer facilement vos fichiers avec un serveur SVN. Ne vous attendez pas à y trouver un exposé très technique de toutes les fonctionnalités offertes par ce logiciel et par Subversion, mais simplement une approche pour les non-informaticiens qui doivent utiliser cet outil. :)

Pour les plus néophytes, SVN (le petit nom de Subversion), c'est quoi ? Il s'agit d'un serveur qui permet la mise en commun de fichiers. Idéal pour le travail collaboratif, il permet de synchroniser les dossiers de travail de toute une équipe, même disséminée dans les quatre coins du globe. En utilisant ce serveur, vous serez sûr de travailler toujours sur les dernières versions des fichiers utilisés, évitant ainsi des échanges hasardeux par email.

On appelle dépôt le dossier commun sur le serveur, et copie de travail le dossier sur votre ordinateur.

Mais les avantages de cette solution ne s'arrêtent pas là : imaginez par exemple que deux personnes travaillent en même temps sur un même fichier, à deux endroits différents. Ils le modifient. L'un met à jour le fichier sur le serveur (action de commit, comme nous le verrons plus loin). L'autre n'a pas encore fini, et ne fera un commit qu'un peu plus tard. SVN sera capable alors de fusionner automatiquement les deux parties modifiées du fichier, sans écraser les modifications des autres. Magique, non ? ;)

L'installation du serveur n'est pas le but de ce billet. Ici, nous allons voir comment l'utiliser pour des non-informaticiens (le but de ce billet, je le rappelle). Nous pourrions utiliser SVN en ligne de commandes, mais cela fera peur aux gens normaux (les non geeks ^^). Nous allons donc utiliser un client graphique des plus simples et des plus efficaces, Tortoise.

Il vous faut tout d'abord le télécharger à l'adresse suivante :

http://tortoisesvn.net/downloads

Il faut choisir la version correspondant à votre architecture (si vous ne savez pas, prenez la version 32 bits). Il faut bien évidemment télécharger l'Installer.

L'installation est tout ce qu'il y a de plus basique, et vous n'aurez donc normalement aucun mal à parvenir à sa fin. Il suffit de tout laisser par défaut, et de cliquer frénétiquement sur le pauvre petit bouton Suivant.

Ensuite, après un éventuel redémarrage, vous aurez de nouvelles options lorsque vous ferez un clic-droit.

Dans notre cas, nous ne nous intéresserons qu'à l'option SVN Checkout. Celle-ci permet de créer en local une copie de travail du dépôt présent sur le serveur.

Dans cette fenêtre, nous définissons tout d'abord l'adresse de notre dépôt (URL of repository). Ensuite, nous indiquons où nous devrons créer notre copie de travail, sur notre machine. Dans ce cas, nous le créeons sur notre disque H. On valide. Il vous demandera probablement un nom d'utilisateur et un mot de passe. Il faudra vous reporter à l'administrateur du dépôt pour obtenir ces identifiants.

Une fois votre copie de travail crée, deux étiquettes peuvent figurer sur votre dossier :

• Signe "validée" sur un disque vert : la copie de travail est synchronisée avec celle sur le serveur.
• Croix rouge : les deux dossiers sont désynchronisés

Lors d'un CheckOut, tous les fichiers, dans les bonnes versions, sont récupérés du serveur. Il n'y a donc pas de resynchronisation à faire.

Faisons un clic droit sur notre dossier afin de voir les options mises à notre disposition :

Les deux options les plus importantes sont :

• Update : Met à jour votre copie de travail en récupérant tous les fichiers du serveur
• Commit : Transfère vos modifications de la copie de travail au dépôt distant

Il est conseillé de mettre à jour votre copie de travail tous les jours (Update), et de commiter à chaque étape importante. Il ne sert en effet à rien de commiter toutes les 5 minutes : cela fait gonfler le nombre de versions présentes sur le serveur, rendant la maintenance pénible. Par exemple, si votre mission est de rédiger un document, vous ne l'enverrez sur le serveur qu'une fois celui-ci achevé, et non pas à chaque CTRL + S. ;)

L'option Show Log vous permettra d'avoir un résumé des dernières actions effectuées sur le dépôt : qui a fait quoi, et quand. Cela peut-être utile pour voir les modifications apportées. Pour le "quoi", il est important d'indiquer les actions effectuées à chaque commit dans la partie "Comments". Cela est essentiel pour s'y retrouver quelques semaines après.

La dernière option que nous verrons ici, dans le cadre d'une utilisation basique, est l'option CleanUp. Si les différents transferts (Update et Commit) ne marchent pas, essayez de faire un petit CleanUp afin de nettoyer le serveur de verrous de fichiers qui n'auraient pas été enlevés, pour une raison plus ou moins mystérieuse. Si cela ne marche toujours pas, alors à ce moment là (et à ce moment là seulement !), vous pourrez contacter votre administrateur système de toute urgence. ;)

Ainsi s'achève ce bref tutoriel sur une utilisation de base de Tortoise SVN pour gérer un dépôt Subversion.