Utiliser Subversion (SVN) avec Tortoise (source: Jonathan Petitcolas - http://www.jonathan-petitcolas.com/utilisersubversion-svn-avec-tortoise/) 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.