CVS sous Windows Howto

Sans un brin d'organisation, un projet collaboratif est mort-né... Notre outil d'organisation, celui proposé par la plateforme Gna! qui nous héberge, c'est le CVS. Correctement utilisé, le CVS simplifie la vie : par exemple si comme moi vous travaillez sur 3 ou 4 ordinateurs différents selon le moment de la journée/semaine/année, vous apprécierez de ne pas avoir à vous demander si vous avez bien la version la plus récente sous la main.

Il semble toutefois que sa mise en oeuvre ne soit pas toujours de tout repos; soit dit sans critiquer, la "doc" Savannah est plus destinée à des administrateurs chevronnés Linux qu'à tout un chacun. Il se peut d'ailleurs que vous travailliez à ce projet de traduction uniquement sur des postes de travail sous Windows (on ne fait pas toujours ce qu'on veut...). Ce petit mode d'emploi vous est destiné.

Que vous faut-il sous Windows pour utiliser CVS confortablement ?

Tout d'abord, il faut pouvoir établir avec le serveur une connexion sécurisée par le protocole SSH; vous avez donc besoin d'un client SSH. Pour ma part j'utilise PuTTY (qui est en fait un client console à distance multi-protocoles), que vous pouvez télécharger ici sous forme d'installeur Windows (pour les curieux, voyez la page d'accueil PuTTY). Ce logiciel nous permettra de générer les clefs de chiffrage nécessaires, et sera utilisé par le client CVS pour établir la connexion au serveur.

Ensuite bien sûr un client CVS; j'ai choisi d'utiliser Tortoise, que vous pouvez télécharger ici.

Les clefs de chiffrage

Dans le dossier où vous avez installé PuTTY, habituellement \program files\putty, vous trouverez le programme puttygen.exe que vous utiliserez pour générer une paire de clefs SSH2 DSA. Sauvez les 2 clefs : la clef privée sera nécessaire pour les connexions, la clef publique ne sera plus nécessaire après inscription sur Gna! mais on ne sait jamais... N'oubliez pas de protéger la clef privée par une phrase-mot de passe.

Tant que nous y sommes, inscrivons la clef publique sur Gna! Sélectionnez la clef dans le champ "Public key for pasting(...)" de l'écran puttygen (n'oubliez aucun caractère) et copiez-la. Connectez-vous sur Gna! et allez à la page de gestion des clefs via la page "Mes préférences". Collez la clef dans le premier champ disponible et envoyez le formulaire. Ensuite, il faut laisser reposer la pâte environ 3 heures (la mise à jour du serveur SSH se fait automatiquement toutes les 3 heures).

PuTTY fournit un agent très pratique pour ne pas devoir entrer la phrase mot de passe qui protège la clef privée à chaque connexion au serveur : pageant.exe. Lancez-le, son icône apparaît dans le panier système. Cliquez-droit dessus et sélectionnez "add key". Naviguez jusqu'à l'endroit où vous avez enregistré la clef privée (fichier .ppk). Ne me dites pas que vous avez oublié où c'est... Tapez la phrase mot de passe pour déverrouiller la clef : si tout se passe bien elle est maintenant disponible tant que votre session est ouverte sur le poste de travail.

Configurer Tortoise

Maintenant configurer Tortoise est un jeu d'enfant : dans le menu Démarrer -> programmes, choisir TortoiseCVS->préférences. Sous l'onglet Outils, il faut configurer "Application SSH" : le programme est plink.exe et est situé dans le répertoire d'installation de PuTTY.

Nous devons maintenant récupérer le répertoire des traduction en cours. Placez-vous à l'endroit où vous voulez le télécharger, cliquez-droit sur le fond de la fenêtre et sélectionnez "CVS Emprunter". Dans la fenêtre Tortoise, effectuez les réglages suivants :

• Protocole : Terminal sécurisé (:ext:)
• Serveur : cvs.gna.org
• Dossier du référentiel : /cvs/sambadoc
• Utilisateur : votre nom d'utilisateur sur gna!
• Module : howto

Validez avec OK : si tout est correct, un dossier "howto" se crée à l'endroit choisi et se remplit avec les fichiers voulus. Votre connexion à Internet était bien ouverte ? Bon, vous êtes prêt à vous y mettre !

Utiliser Tortoise pour synchroniser votre version locale avec le dépôt CVS

Pour récupérer les modifications aux fichiers depuis votre dernière connexion : cliquez-droit sur le dossier, sélectionnez "CVS Actualiser". Je vous conseille de toujours actualiser l'ensemble du dossier avant de commencer à travailler sur un fichier.

Pour transférer sur le serveur les modifications que vous venez d'effectuer, cliquez-droit sur le fichier modifié (ou le dossier s'il y en a plusieurs), et sélectionnez "CVS Valider". N'oubliez pas de le faire avant de clôturer votre session de traduction quotidienne ;-). Vous pouvez aussi ajouter un commentaire qui apparaîtra dans l'historique des versions (si plusieurs fichiers sont modifiés et que vous validez tout le dossier, ce sera le même commentaire pour tous les fichiers, toutefois).

Have fun !

Si vous remarquez des erreurs dans cette page ou si malgré tout vous avez des difficultés à appliquer les procédures qui y sont décrites, écrivez-moi via mon profil Gna!.

Cidrolin.