wiki:svn

Introduction

SVN (abrégé de subversion) est un logiciel qui permet de gérer les différentes versions d'un ensemble de fichiers. Indispensable pour le développement collectif de codes complexes, il peut être aussi très utile pour l'écriture d'articles ou de code personnel.

En savoir plus :



Configuration de SVN au LPSC

Cette page a pour but de vous permettre d'installer et de configurer votre client SVN (subversion) afin d'utiliser les ressources de gestion de version proposées par le service informatique du LPSC.

Nous hébergeons des repository pour gérer les versions des codes informatiques de nos groupes et services à l'aide d'un serveur svn accessible via https, sur une adresse du type https://lpsc.in2p3.fr/svn/xxx/ (pour les accès par certificat) ou https://lpsc-secure.in2p3.fr/svn/xxx/ (pour les accès par login / mot de passe).

La liste des actions à effectuer est la suivante :

  1. Votre responsable de projet doit vous fournir l'adresse exacte de votre repository et me faire parvenir (melot AT in2p3 . fr) une demande officielle de votre participation au repository du projet.
  2. Vérifiez que vous possédez un client SVN. Si vous ne possèdez pas de client, téléchargez-en un ici et installez le. Pour la compilation lancez : configure --prefix=/xxx/xxx --with-ssl, make puis make install.
  3. 2 types d'authentification sont supportées : celle par certificat (recommandée) et celle par login / mot de passe, si vous ne pouvez pas obtenir de certificat
  • Si vous êtes agent CNRS, demandez un certificat CNRS standard, à l'URL : http://igc.services.cnrs.fr/CNRS2-Standard (choisir une demande de certificat personnel, ne pas utiliser d'accent dans les champs à renseigner et donner votre adresse mail indiquée dans LDAP si vous travaillez pour l'IN2P3)

Note à l'attention des administrateurs : DN renseignés dans /usr/local/SVN_access_file sur lpsc.

  • Si vous pouvez obtenir un certificat non CNRS, contactez-moi (melot AT in2p3 . fr) afin de me fournir un lien vers le certificat de votre autorité de certification
  • Sinon contactez-moi (melot AT in2p3 . fr) que je vous crée un login / mot de passe
  1. Si vous vous authentifier à l'aide d'un certificat :
  • Après réception du mail vous avertissant de la création de celui-ci, importez-le dans votre navigateur
  • Importez également dans votre navigateur toute la chaîne de certification (s'il s'agit d'un certificat CNRS, sur http://igc.services.cnrs.fr/CNRS2-Standard ou https://igc.services.cnrs.fr/GRID2-FR pour les certificats GRID2, choisisez 'Certificats AC' dans les menus de gauche puis 'Chargement dans le navigateur' de 'Toute la chaîne de certification'). Vous devez également spécifier à votre navigateur que vous tous les certificats de la chaîne de certification peut identifie les sites web (menus 'Edit / Preferences / Advanced / Encryption / View Certificates / Autorities / choix des certificats / Edit puis 'This certificate can identify web sites' dans firefox)
  • Exportez votre certificat, à partir de votre navigateur, sur votre disque local ('Edit' / 'Preferences' / 'Advanced' / 'Secutity' / 'View Certificates' / 'Your certificates' / 'Backup') dans un répertoire protégé en lecture (ex : $HOME/.ssh)
  • Essayer une tentative de connexion à votre repository dans votre navigateur et tenez-moi au courant afin que je récupère votre DN ou envoyez le moi directement
  • si dans votre home directory vous ne possédez pas encore de répertoire gérant vos préférences pour subversion ($home/.subversion sous linux ou C:\Documents and Settings\nom\Application Data\Subversion sous windows), lancez une fois la commande svn, ce répertoire apparaîtra.
  • éditez le fichier servers pour y faire apparaître :

[groups]

# group1 = *.collab.net

# othergroup = repository.blarggitywhoomph.com

# thirdgroup = *.example.com

lpsc=lpsc.in2p3.fr

[lpsc]

ssl-client-cert-file=/xxx/certificat.p12 (emplacement de votre certificat sur votre disque)

  1. Vous devriez maintenant pouvoir vous connecter au repository désiré, en utilisant par example la commande svn list https://lpsc.in2p3.fr/svn/xxx (accès par certificat) ou svn list https://lpsc-secure.in2p3.fr/svn/xxx (accès par login / mot de passe)

Message d'erreur courant

Si vous obtenez l'erreur suivante : "Could not read status line: SSL alert received: Echec de négociation (https://lpsc.in2p3.fr)", il s'agit probablement d'un souci de librairie pour lequel une intervention du service informatique sera nécessaire. N'hésitez donc pas à passer nous voir.



Utilisation courante de SVN

Que faut-il faire pour pouvoir l'utiliser ?

  1. Récupérer votre dossier sur votre compte en faisant
    svn checkout https://lpsc.in2p3.fr/svn/bidul/mon_repertoire
    
  2. Allez dans votre répertoire, créez votre document...
    mkdir these
    emacs these.tex
    
  3. Ajoutez les fichiers que vous voulez à svn (de préférence sans les fichiers compilés ou les pdf que vous pouvez toujours refaire)
    svn add these
    svn add these/*.tex
    
  4. Envoyez (commit) vos modifications à svn
    svn commit
    

Quelques commandes de svn

  • Pour l'aide : svn help [commande]
  • Vous pouvez ajouter des fichiers ou des répertoire à votre projet avec svn add.
  • Toute modification doit être "commitée" pour être prise en compte : svn commit
  • Il existe aussi svn copy, svn delete, svn move... Voir par exemple sur wikipedia pour une liste plus complète.

Remarque : les caractères sont encodés en UTF-8. Si vous utilisez des accents vérifiez que ceux-ci ne sont pas perdus...

Last modified 3 years ago Last modified on Jul 2, 2018 3:48:06 PM