Windows, ssh et tortoise

lundi 2 avril 2012
par  Franck Pérignon

Cet article décrit sommairement l’utilisation de svn+ssh sur une machine windows, pour accéder au dépôt svn d’un projet.

Introduction

Deux outils sont nécessaires :

Putty permet de configurer une connexion ssh (pour plus de détails voir par exemple ssh sur wikipedia) qui vous donnera un accès sécurisée sur le(s) dépôt(s) svn de vos projets.

Tortoise est un outil windows pour accéder aux commandes de subversion et gérer un dépôt partagé.
Compléments :

Installation et configuration

Télécharger et installer putty et tortoise via les liens donnés plus-haut.
Garder les options par défaut de l’"installer" windows.

Création d’une clé publique et d’une clé privée

  1. lancer PuTTYGen
  2. changer la valeur "number of bits in a generated key", mettre 2048 (en bas de la fenêtre)
  3. cliquer sur "Generate" et suivre les instructions pour obtenir quelquechose comme ceci :
    PNG - 52.9 ko
  4. copier le texte qui suit la ligne "Public key for pasting etc ..." et le sauvegarder dans un fichier "id_rsa.pub". Copier le contenu de ce fichier comme indiqué ici.
  5. renseigner "Key passphrase" et "confirm passphrase". Cette passphrase sera nécessaire pour toutes vos connexions sur la forge via ssh.
  6. Sauvegarder la clé publique et la clé privée

Configuration de putty

  1. lancer Putty/Pageant. Pageant tourne en tâche de fond et apparait dans la barre d’outil (icône : un ordinateur surmonté d’un chapeau ...)
  2. clique droit sur Pageant (le chapeau dans la barre d’outil) -> add key ;
    choisir le fichier qui correspond à votre clé privée (celui que vous avez sauvegardé à la dernière étape de la section précédente). Si tout se passe bien, pageant doit vous demander votre passphrase.

Remarque : les deux étapes ci-dessus (création des clés et configuration de putty) ne sont nécessaires qu’à la première "connexion" à un dépôt svn sur la forge. La clé ssh (avec sa passphrase) est ensuite valable pour tous vos projets.

Utilisation de Tortoise

Note : pour le détail des commandes svn, voir utilisation de svn.

  1. Créer un répertoire, où vous voulez. Ce répertoire sera utilisé en local pour rapatrier le dépôt svn de votre projet et travailler sur celui-ci.
  2. Aller dans ce répertoire
  3. clique droit + SVN Checkout, vous obtenez la fenêtre suivante :
    PNG - 29.5 ko
    Dans "URL of repository", copier la ligne donnée dans l’onglet Source/SCM de votre projet, sur la forge (tout ce qui suit svn+ssh ://...), puis "OK".

Vous pouvez maintenant travailler sur votre copie locale.

Les principales commandes svn sont accessibles via un clique droit sur les répertoires ou fichiers.

Remarques :

  • pour que Tortoise fonctionne correctement, il faut que pageant tourne. Vous devez donc le lancer à chaque session Windows ou faire le nécessaire pour qu’il démarre automatiquement.