Utiliser SVN

Subversion (en abrégé svn) est un système de gestion de versions. La suite du guide suppose que vous êtes connecté en ssh à la racine de votre hébergement.

Pre-requis

• Avoir un hébergement qui permet une connection ssh (à partir de l'offre Pro)
• Savoir se connecter en SSH (vous pouvez pour cela vous aider de ce guide )

Creation du depot

Une fois connecté en SSH sur votre hébergement, il vous faut créer le répertoire racine des dépôts svn et ensuite le dépôt.

Il vous suffit pour cela de taper la commande :

mkdir svn

et

svnadmin create svn/depot_test

Vous pouvez ensuite vérifier que les repertoires ont été crées avec la commande :

ls -la

Vous devez obtenir les repertoires comme indiqué sur l'image suivante :

Creation des cles publiques / privées

Linux avec openssh

Cette partie se déroule sur l'ordinateur qui se connectera au dépôt svn (le client svn). Il faut créer une paire de clé dsa. Pour cela taper dans votre terminal la commande :

ssh-keygen -t dsa

et récupérer la ligne qui se trouve par défault dans le fichier .ssh/id_dsa.pub . Pour editer le fichier il vous suffit d'utiliser la commande: vi.

vi .ssh/id_dsa.pub

Vous trouverez la clef qui est divisée en trois chaînes de caractères : le type, la clé et un commentaire.

Windows avec putty

Cette partie se déroule sur l'ordinateur qui se connectera au dépôt svn (le client svn). Télécharger l'installer windows putty et l'installer. Il faut créer une paire de clés dsa. Pour cela lancer PuTTYGen, générer une paire de clé et les sauvegarder :

Ajout de la cle publique sur l'hebergement

Aprés avoir obtenu votre clef il vous faut l'ajouter sur votre hebergement dans le fichier .ssh/authorized_keys2. Il vous suffit pour cela de taper la ligne de commande ci-dessous :

mkdir .ssh
chmod 700 .ssh
vi .ssh/authorized_keys2

Une fois le fichier ouvert vous devez y inserer la ligne suivante :

command="/usr/bin/svnserve --root=/homez.XXX/loginFTP/svn --tunnel --tunnel-user=marc",no-port-forwarding,no-agent-forwarding,no-X11-forwarding,no-pty

suivi de la clé précédemment créée, le tout sur la même ligne !

La personne pourra donc récupérer le contenu du dépôt sans pouvoir pour autant se connecter directement en ssh sur la machine.

Exemples

Sous Linux

Vous pouvez faire un test depuis l'ordinateur se connectant au depot svn en tapant la ligne :

svn checkout svn+ssh://loginFTP@clusterXXX/depot_test

Windows avec TortoiseSVN

• Télécharger tortoisesvn et l'installer ( http://tortoisesvn.net/downloads )
• Double cliquer sur la clé privée. Une icône apparait en bas à droite, la clé est alors chargée dans l'agent d'authentification.
• Créer un répertoire, cliquer droit dessus et sélectionner "SVN Checkout". Entrer :

dans le champ "URL of repository" et cliquer sur OK :

Il existe une très bonne documentation en anglais pour Subversion : http://svnbook.red-bean.com/en/1.5/index.html

Cas specifiques

Creer plusieurs Comptes

Il faut tout d'abord avoir créer plusieurs clés ssh. Ensuite lors de l'ajout de la clé publique sur l'hébergement :

command="/usr/bin/svnserve --root=/home.XXX/loginFTP/svn --tunnel --tunnel-user=marc",no-port-forwarding,no-agent-forwarding,no-X11-forwarding,no-pty

Vous devez modifier le paramètre ci-dessous en y ajoutant vos différents utilisateurs :

--tunnel-user

à noter qu'il est aussi possible de donner des accès en lecteur seule en ajoutant le paramètre :

--read-only.

Check en local depuis le serveur

Lorsque vous voudrez faire le checkout en local, les exemples fournis ne fonctionneront pas. Il vous faudra utiliser :

svn+ssh://login@ftp.nom-du-site.tld/home.XXX/login/svn/depot_test

Aller plus loin

Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com.

Ces guides pourraient également vous intéresser...