Utilisation de SVN

Svn (subversion) est le successeur de CVS et permet la gestion collaborative de développement de codes ou de documents.

Informations générales

La machine sur laquelle est installée le serveur svn est aussi la machine qui contient physiquement les dépôts.

- Machine : 193.48.123.84 (d84.lama.univ-savoie.fr) (ci après serveur)

- Répertoire qui contient les dépôts : /export/svn : ici après PATH

Informations pour utilisation

Avant de pouvoir créer un dépôt, vous devez avoir été ajouté au groupe des utilisateurs de svn et l'administrateur doit créer la racine du dépôt : merci donc de venir me voir ou m'envoyer un mail avec le nom du projet et les participants.

Utilisation basique

• Création du dépôt

Se logger sur le serveur svn : d84.lama.univ-savoie.fr Dans le répertoire dédié aux dépots (/export/svn) L'utilisateur doit créer le dépôt initial avec la commande svnadmin create PROJET_A.

ATTENTION A CHANGER LES DROITS DE L'ENSEMBLE DU REPERTOIRE POUR METTRE LES FICHIERS EN ECRITURE POUR TOUS LES MEMBRES DU GROUPE ! (chmod -R g+rw *).

Ici PATH fait référence à /export/svn

• Initier un dépôt (premier dépôt des sources)

depuis votre machine locale : svn import -m "Version originale" REPERTOIRE_LOCAL svn+ssh://USER@serveur/PATH/PROJET_A (Remplacer les majuscules par vos valeurs). Cela permet de mettre pour la première fois le répertoire ou les fichiers à versionner

• Récupérer un dépôt existant

Depuis votre machine locale Commande à exécuter dans le répertoire parent, qui contiendra la copie locale : svn checkout svn+ssh://serveur/PATH/PROJET_A.

Si l'authentification est requise pour votre dépôt, précisez votre nom d'utilisateur de cette manière : svn checkout svn+ssh://USER@serveur/PATH/PROJET_A

• Récupérer une partie seulement d'un dépôt existant

Commande à exécuter dans le répertoire parent, qui contiendra la copie locale : svn checkout svn+ssh://serveur/PATH/PROJET_A/SousRep. Avec authentification : svn checkout svn+ssh://USER@serveur/PATH/PROJET_A/SousRep

• Récupérer la dernière version d'un dépôt

Depuis la copie de travail locale (le répertoire local qui contient le projet) : svn update

• Enregistrer des modifications dans un dépôt

Depuis la copie de travail locale (le répertoire local qui contient le projet) : svn commit -m "Message"

• Ajout de fichiers dans un dépôt
  • Ajout d'un fichier :

svn add filename et ensuite faire un commit des modification avec svn commit.

• • Ajout de plusieurs fichiers

Pour ajouter plusieurs fichiers d'un répertoire, la commande suivante le fait toute seule : /usr/bin/svn status | /bin/grep '?' | /bin/sed -e 's/^\?[ ]*//' | /usr/bin/xargs -iFILE /usr/bin/svn add "FILE" ou encore on peut utiliser svn add * --force : ajout de tout les nouveaux fichiers récursivement.

• • Ajout d'un répertoire entier

svn add REPERTOIRE. La commande "svn add" étant par défaut récursive, elle permet d'ajouter la totalité du répertoire.

Attention : pensez à faire un update, vos modifications et ensuite un commit

Documentations diverses

http://subversion.tigris.org/

http://www.limsi.fr/Individu/pointal/subversion/

LE LIVRE : http://svnbook.red-bean.com/en/1.5/