Utiliser le dépôt SVN d'une forge FusionForge sur Microsoft Windows Sommaire Introduction...2 Configuration SSH...2 Installation de PuTTY...2 Génération de clé SSH...2 Utilisation d'une clé SSH externe...3 Configuration de Pageant...4 Installation de la clé publique sur la forge...4 Configuration-Utilisation du SVN...5 Installation de TortoiseSVN...5 Checkout...6 Manipulation des fichiers/dossiers...7 Fichier/dossier non modifié...8 Fichier/dossier modifié...8 Fichier/dossier ajouté...8 Fichier/dossier supprimé...8 Propager les modifications Commit...8 Mise à jour de sa version Update...9 Autres opérations...10 Date Auteur Version Commentaire 12/08/10 J. Couteau 1 Première révision
Introduction Les forges FusionForge utilisent SVN et SSH pour la gestion des versions des documents d'un projet. SVN est un gestionnaire de version, et SSH est un protocole de communication sécurisé. Afin de l'utiliser correctement et simplement sur Microsoft Windows, il vous faudra installer et configurer deux logiciels, PuTTY et TortoiseSVN, chacun gérant une partie du process. Configuration SSH Installation de PuTTY PuTTY est une application permettant d'utiliser SSH sur Microsoft Windows. Il vous faudra télécharger la dernière version de l'installeur à l'adresse suivante : http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Lancez l'installeur, vous pouvez choisir les options par défaut ou les modifier à votre convenance. PuTTY est maintenant installé sur votre ordinateur. Génération de clé SSH Note : Si vous souhaitez utiliser une clé SSH que vous possédez déjà, veuillez passer à l'étape suivante. Si vous n'avez pas de clé SSH, il faut en générer une avec PuTTY. Pour ce faire, lancez PuTTYgen, l'utilitaire de génération de clé de PuTTY. Générez une clé en cliquant sur le bouton. Bougez la souris au dessus de la fenêtre, cela génère des nombres aléatoires qui améliorent la sécurité de la clé.
Vous pouvez remplacer le commentaire de la clé. Il est en général conseillé de mettre ici son nom et/ou le nom de l'ordinateur. Vous pouvez mettre ensuite une passphrase (un mot de passe) sur la clé SSH, mais si celle-ci n'est destinée qu'à l'utilisation de SVN, ce n'est pas nécessaire. Enregistrez ensuite la clé publique et la clé privée sur votre ordinateur en utilisant les boutons et. Il n'existe pas de norme pour la localisation des clés SSH sur Microsoft Windows, néanmoins nous recommandons de les mettre dans le répertoire : C:/Documents And Settings/Utilisateur/Application Data/ssh (Attention, Application Data est un dossier caché, il vous faudra peut-être le rendre visible au préalable). Utilisation d'une clé SSH externe Note : Si vous avez généré une clé SSH à l'étape précédente, passez directement à l'étape suivante. Vous souhaitez utiliser une clé SSH que vous avez déjà généré ou que quelqu'un a déjà généré pour vous. Il vous faudra réenregistrer cette clé au format PuTTY, car celui-ci ne gère pas, par exemple, les clés générées par OpenSSH. Lancez PuTTYgen, le manipulateur/générateur de clés SSH de PuTTY.
Chargez la clé privée déjà générée en cliquant sur le bouton si vous le souhaitez, ce dernier étant modifié par PuTTY.. Vous pouvez changer le commentaire de la clé Enregistrez votre clé privée au format PuTTY en cliquant sur le bouton. Configuration de Pageant Pageant est l'agent SSH de PuTTY. Une fois configuré et lancé, c'est lui qui permet aux autres applications d'utiliser le protocole SSH. Commencez par lancer Pageant. Il devrait se réduire dans la barre des taches de Microsoft Windows (l'ordinateur avec un chapeau). Ajoutez votre clé en faisant un clic droit sur l'icône de Pageant puis en cliquant sur 'Add Key'. Choisissez votre clé privée et validez. Installation de la clé publique sur la forge Maintenant que l'ordinateur est configuré pour utiliser la clé privée, il faut donner la clé publique à la forge, afin que celle-ci nous identifie. Pour cela, il faut se connecter sur la forge et se rendre sur son compte (Lien Mon compte, en haut à droite de la page d'accueil). En bas de la page de modification du compte, une boîte nommée 'Informations relatives au compte shell' contient les
clés publiques liées au compte. Il faut cliquer sur le lien 'Editer les clés' pour en rajouter une. Vous arrivez sur une page contenant une seule zone de texte. Vous devez copier ici votre clé publique (depuis PuTTYgen, ou alors en ouvrant le fichier dans lequel vous l'avez enregistré avec Notepad ou tout autre éditeur de texte). Attention : La clé doit être copiée sur une seule ligne (ne contenir aucun saut de ligne), si ce n'est pas le cas, cela ne fonctionnera pas. Cliquez ensuite sur 'Mettre à jour'. Vérifiez ensuite, dans votre compte, que vous avez bien une clé enregistrée (ou plus si ce n'était pas la première) à la ligne 'Clés publiques SSH autorisées'. Vous avez maintenant terminé de configurer SSH, et sur votre ordinateur, et sur la forge. Il ne reste plus qu'à s'occuper du SVN. Configuration-Utilisation du SVN Installation de TortoiseSVN TortoiseSVN est une application qui intègre les fonctions de gestionnaire de version SVN à l'explorateur Windows. Téléchargez la dernière version de TortoiseSVN depuis le site du projet : http://tortoisesvn.net/downloads. Lancez l'installeur, vous pouvez choisir les options par défaut ou les modifier à votre convenance.
TortoiseSVN est maintenant installé sur votre ordinateur. Checkout Pour télécharger un projet, depuis la forge FusionForge, il vous faudra d'abord créer un dossier destiné à accueillir le projet. Placez vous dans ce dossier. Faites un clic droit puis cliquez sur 'SVN Checkout'.
Une fenêtre va s'ouvrir vous demandant l'adresse du dépôt. Vous devez mettre ici l'adresse qui vous a été donné par l'administrateur ou le responsable du projet, ou alors que vous avez pu trouver sur la forge, dans l'onglet 'Source' du projet. Validez, TortoiseSVN va télécharger tous les fichiers du projet depuis la forge FusionForge. Note : Il est possible que vous tombiez sur un message vous avertissant que le serveur n'est peut-être pas le bon. Cliquez sur 'Yes', cela enregistrera l'empreinte du serveur et vous avertira si cette dernière change. Manipulation des fichiers/dossiers Une fois que le projet a été téléchargé sur votre ordinateur, les icônes des fichiers/dossiers du projet sont modifiés, cela signifie que les dossiers/fichiers sont versionnés. Pour manipuler les fichiers, vous devez passer par le menu de TortoiseSVN, de plus, lorsque vous voulez propager ces modifications (les communiquer aux autres membres du projet), certaines opérations sont nécessaires. Nous allons voir ici la signification des icônes et les opérations à effectuer suivant les modifications.
Fichier/dossier non modifié Un fichier que vous n'avez pas modifié voit un 'tick' vert se rajouter à son icône. Vous n'avez alors rien à effectuer pour la propagation des modifications, vu qu'il n'y en a pas. Fichier/dossier modifié Un fichier modifié voit un point d'exclamation rouge se rajouter à son icône. Vous n'avez alors rien à effectuer pour la propagation des modifications. Fichier/dossier ajouté Un fichier supprimé voit un point d'interrogation bleu se rajouter à son icône. TortoiseSVN ne sait pas si vous souhaitez versionner le fichier ou l'ignorer. Il faut alors faire un clic droit sur le fichier en question et, sur le menu TortoiseSVN, soit choisir 'Add', soit choisir 'Add to Ignore List' (Ignorer). Vous pouvez alors choisir d'ignorer le fichier en question ou alors tous les fichiers du même type (cela ignorera uniquement dans ce dossier). Un fichier ajouté aura un plus bleu rajouté à son icône, un fichier ignoré aura un sens interdit gris. Fichier/dossier supprimé Un fichier supprimé n'est plus visible dans l'explorateur. Vous n'avez rien à faire. Propager les modifications Commit Une fois que les modifications sont terminées ou que vous avez une version à synchroniser, vous devez propager les
modifications que vous avez effectuer pour que les autres membres du projet puissent en bénéficier. Pour cela, utilisez la commande 'SVN Commit' depuis le menu TortoiseSVN. Vous devez rajouter un message explicite indiquant aux autres membres du projet ce que cette version ajoute/modifie par rapport à la précédente (pas besoin d'écrire un roman non plus). Il est possible, à partir de cette fenêtre, de choisir les modifications à envoyer au serveur (vous pouvez cocher, décocher les fichiers à synchroniser). Une fenêtre vous indiquera la progression de l'opération. Mise à jour de sa version Update Il vous faudra régulièrement mettre à jour votre version de travail, pour obtenir les modifications apportées par les autres membres du projet. Pour cela, il faut utiliser la commande 'SVN Update' depuis le menu TortoiseSVN.
Une fenêtre vous indiquera la progression de l'opération. Autres opérations Pour toutes les opérations que vous pourriez souhaiter effectuer, il est conseillé de se reporter à la documentation de TortoiseSVN, disponible sur leur site Internet à l'adresse : http://tortoisesvn.net/support, ou disponible en appuyant sur 'F1' dans une fenêtre de dialogue de TortoiseSVN.