Subversion HowTo
Well, you chose to host at Tuxfamily, that's good. You've chosen a subversion repository, that's better. We are going to explain how it all works.
basic use
Nous partons du principe que vous souhaitez faire ici une utilisation basique de Subversion. Commencez par faire un checkout de votre repository
svn co svn+ssh://VOTREUSER@svn.tuxfamily.org/svnroot/VOTREPROJET/NOMDUREPOSITORY
(remplacez bien sur VOTREUSER par votre nom d'utilisateur sur le panel, VOTREPROJET par le nom du projet auquel appartient le repository de nom NOMDUREPOSITORY).
Attention, votre mot de passe risque de vous être demandé plusieurs fois, jusqu'à 3 fois. Cela n'est pas un bug, c'est dû à svn qui utilise plusieurs connexions, il vous faudra donc rentrer votre mot de passe autant de fois qu'il vous sera demandé, ou utiliser une clef ssh (voir plus bas).
Normalement, vous devriez avoir quelque chose dans ce goût là :
[soda@evira:/tmp/subversion] svn co svn+ssh://sod@svn.tuxfamily.org/svnroot/vhffs4/vhffs repertoire
Révision 0 extraite.
[soda@evira:/tmp/subversion] $
Alléluïa, la première version est née. D'ailleurs, elle se situe dans le répertoire
repertoire (ajouté à la fin de la commande).
Maintenant, nous allons agir dans le repository en lui ajoutant des fichiers ou des répertoires.
Add/delete files, update repository
Add a file
Entrons donc dans notre répertoire
cd repertoire/
Et créons un fichier appelé
file
touch file
Ensuite, pour l'ajouter au repository, tapez simplement
svn add file
Enfin, pour envoyer le tout sur le serveur, invoquez la commande suivante :
svn ci (ci = commit)
Pour les répertoires, nous aurions procédé de la même façon
svn add directory (directory étant un répertoire déjà créé)
puis :
svn ci
Delete a file
Pour supprimer un fichier présent dans le repository, tapez simplement
svn rm file
puis envoyez vos modifications sur le serveur
svn ci
Update your repository
Quand on travaille en groupe, il peut être utile de pouvoir mettre à jour son dépot subversion. Pour cela, il suffit d'invoquer la commande suivante à la base du repository
svn up
Anonymous use of Subversion
Il est possible d'utiliser Subversion en anonyme. Cependant, vous n'aurez pas le droit de modifier le repository (suppression ou modification de fichiers). Pour faire un 'checkout' du repository, invoquez la commande suivante :
svn co svn://svn.tuxfamily.org/svnroot/VOTREPROJET/NOMDUREPOSITORY
Il est également possible de mettre à jour le repository au fur et à mesure que les développeurs mettent à jour le code via un simple
svn up
Attention cependant, le mode anonyme n'est disponible que si votre repository est mis en public (réglage par défaut)
Svnweb
Vous pouvez consulter les repositories par le web à l'adresse suivante :
http://svnweb.tuxfamily.org.
Les repositories sont présentés et les projets auxquels ils appartiennent sont entre parenthèses.
Obtaining news regularly about your repository
Il est possible d'avoir des informations régulières à propos de votre repository. Il suffit pour cela d'utiliser le feed RSS placé sur le
svnweb de votre repository. Par exemple, pour avoir les news régulières du repository
sodrepo, utilisez le fichier XML suivant :
http://svnweb.tuxfamily.org/rss.php?repname=sodrepo+%28sodgroup%29&path=%2F&rev=0&sc=0&isdir=1 . Chaque repository dispose d'un feed RSS, il vous suffit donc de l'utiliser.
Use a graphical interface
Si vous êtes allergiques à la ligne de commande pourtant fort pratique, vous pouvez utiliser eSVN jusqu'à ce que le support de svn soit correctement opérationnel dans cervisia (qui vous sert peut-être déjà pour cvs).
Peut-être y-aura-t-il tortoiseSVN disponible pour GNU/Linux un jour ?
Put your SSH public key
Il est possible de déposer votre clé SSH (publique) sur les serveurs de Tuxfamily. Cela vous permet de ne pas taper votre mot de passe à chaque opération effectuée sur le serveur Subversion.
- Pour la déposer, il faut copier le contenu de votre clé publique dans le fichier ssh_keys qui est dans votre répertoire de départ (répertoire home). Ce répertoire home est celui sur lequel vous arrivez lorsque vous vous identifiez sur le serveur FTP.
- Ce fichier doit être placé et avoir un chmod de 700.
Autrement dit, seul VOUS, utilisateur, avez le droit de lire, d'écrire et d'exécuter ce fichier.
Votre clé publique ssh est dans
~/.ssh/id_rsa.pub ou
id_dsa.pub (si vous avez retenu un mode faiblard d'encryption)
Where can I find more complete documentation ?
DANS TON navigateur web, sur le site de référence :
http://subversion.tigris.org
ou encore en français pour ceux qui préfèrent :
https://svnhost.gi.polymtl.ca/utilisationSVN.html
sachant que la référence est le svnbook :
http://svnbook.red-bean.com/en/1.1/index.html [en] que vous pouvez contribuer à traduire en français vu qu'il n'est actuellement disponible qu'en español, Italiano, norsk, Russian :-(
I've got problems to use my repository
Si vous avez un problème avec l'utilisation des serveurs, n'hésitez pas à mailer modo at staff dot tuxfamily dot org