Voir la source de Gestion de versions : utilisation de base de Subversion

[[Catégorie:Informatique]]

Cette page présente les commandes les plus courantes, afin de permettre de prendre en main rapidement le système de gestion de versions Subversion. Ne seront pas expliqués ici les principes de la gestion de versions. Voir à ce sujet la page [http://fr.wikipedia.org/wiki/Gestion_de_versions Gestion de versions] sur Wikipédia. Une documentation plus détaillée sur Subversion figure à l'adresse http://svnbook.red-bean.com/.

Voyez aussi la page [[Gestion de versions avec Subversion, Apache, OpenSSL]] pour des explications sur l'installation d'un serveur de gestion de versions. Il est bien sûr possible d'utiliser Subversion sans mettre en place toute cette infrastructure, notamment dans le cas d'une utilisation par un nombre très réduit de personnes ; l'accès se fera alors plutôt en local, ou à distance via SSH (voir le paragraphe [[#Accès aux dépôts|Accès aux dépôts]]).

== Création d'un dépôt ==

Comme indiqué dans le [[Gestion de versions avec Subversion, Apache, OpenSSL|tutoriel d'installation]], la création d'un dépôt se fait grâce à la commande <tt>svnadmin</tt>. En simple utilisateur, ou en root si vous n'avez pas accès en modification au répertoire des dépôts :
 # svnadmin create /home/svn/nom_depot

Si vous avez opté pour une gestion centralisée des dépôts et un accès via Apache, il faut donner un accès en écriture à l'utilisateur qui lance Apache (le compte ''www-data'' sous Debian) :
 # chown -R www-data /home/svn/nom_depot

'''''Note :''' Le nom d'un dépôt peut contenir des caractères accentués lors d'une utilisation en local, mais lors de l'utilisation via Apache, la présence de tels caractères empêche l'accès au dépôt.''

== Accès aux dépôts ==

Pour accéder à un dépôt, on utilise le programme <tt>svn</tt>, auquel on passe une [http://fr.wikipedia.org/wiki/URI URI], qui peut être de l'une des formes suivantes :
* <tt><nowiki>file:///répertoire/du/dépôt</nowiki></tt> : accès à un dépôt local.
* <tt><nowiki>http://serveur/chemin/depot</nowiki></tt> : accès à un dépôt distant via le protocole HTTP.
* <tt><nowiki>https://serveur/chemin/depot</nowiki></tt> : accès à un dépôt distant via HTTP sécurisé.
* <tt><nowiki>svn+ssh://serveur/répertoire/du/dépôt</nowiki></tt> : accès à un dépôt distant via SSH.
* <tt><nowiki>svn://serveur/répertoire/du/dépôt</nowiki></tt> : accès à un dépôt distant via le protocole interne de Subversion.

Dans le cadre de la configuration décrite sur la page [[Gestion de versions avec Subversion, Apache, OpenSSL]], nous utiliserons une adresse du type <tt><nowiki>https://serveur/svn/depot</nowiki></tt>.

Pour se simplifier la vie, il peut être utile de créer une variable contenant l'adresse du répertoire de base des dépôts. On peut par exemple placer, dans son <tt>~/.bashrc</tt> (si on utilise Bash) ou <tt>~/.zshenv</tt> (si on utilise Zsh), une ligne de la forme :
 export SVNROOT=<nowiki>https://serveur/svn</nowiki>
ou, si on accède aux dépôts en local et en supposant que les dépôts se trouvent dans <tt>/home/utilisateur/svn</tt> :
 export SVNROOT=file:///home/utilisateur/svn
De même quel que soit le protocole d'accès à Subversion… Ainsi on pourra accéder de manière plus simple à un dépôt en utilisant <tt>$SVNROOT/nom_du_dépôt</tt>.

== Commentaires de révisions ==

À chaque modification que vous effectuez sur le dépôt (ajout, modification, déplacement de fichiers), une nouvelle '''révision''' sera créée dans le dépôt. Lorsque vous propagez une nouvelle révision, vous êtes invité à décrire brièvement les changements effectués (et à donner toute autre information jugée utile). Vous pouvez renseigner ce commentaire de trois manières :
* Grâce à l'option <tt>'''-m'''</tt> de <tt>svn</tt>, qui permet de donner le commentaire directement depuis la ligne de commande. Exemple : <tt>svn import un/répertoire $SVNROOT/nom_du_depot -m "Import initial."</tt>
* Grâce à l'option <tt>'''-F'''</tt> de <tt>svn</tt>, qui permet de spécifier que le commentaire à utiliser figure dans un fichier préparé à l'avance. Exemple : <tt>svn ci -F /tmp/commentaire.txt</tt>
* En l'absence de ces deux options, <tt>svn</tt> lancera un éditeur de texte (l'éditeur de texte par défaut, par exemple celui spécifié dans la variable d'environnement <tt>$EDITOR</tt>) de manière à ce que vous saisissiez le commentaire. Le fichier présente la liste des modifications apportées (et donc à commenter), et vous devez placer votre commentaire au-dessus de la ligne indiquée. On pourra par exemple obtenir, après remplissage du commentaire, un fichier de la forme suivante (ici les fichiers <tt>main.c</tt> et <tt>main.h</tt> ont été modifiés, et le fichier <tt>images/individu1.png</tt> créé) :
 Modification de la gestion des paramètre de la gestion collaborative du tracking de l'individu dans main.c.
 main.h : en-tête de la fonction track_individu() modifié en fonction.
 Ajouté la photo de l'individu n°1 (images/individu1.png).
 --Cette ligne, et les suivantes ci-dessous, seront ignorées--
 
 A    images/individu1.png
 M    main.c
 M    main.h

== Importation de données dans le dépôt ==

Dans le cas où on veut versionner un projet déjà existant, ou créer une sous-arborescence importante dans un dépôt, le plus simple est d'utiliser la commande <tt>svn import</tt>.

Dans les exemples suivants on considérera que nous avons, dans notre répertoire utilisateur, un répertoire <tt>projet</tt> qui contient l'arborescence suivante :
 projet
 |-- images
 |   `-- test.png
 |-- main.c
 `-- main.h

Pour importer le répertoire <tt>projet</tt> à la racine du dépôt $SVNROOT/depot :
 $> svn import rép $SVNROOT/depot
La racine du dépôt sera similaire au répertoire <tt>projet</tt> :
 $> svn ls $SVNROOT/depot
 images/
 main.c
 main.h

Pour importer le répertoire <tt>/tmp/musique</tt>, contenant les fichiers <tt>1.ogg</tt> et <tt>2.ogg</tt>, dans le dépôt $SVNROOT/depot, dans un sous-répertoire <tt>sound</tt> :
 $> svn import /tmp/musique $SVNROOT/depot/sound
La racine du dépôt se présentera à présent de la façon suivante :
 $> svn ls $SVNROOT/depot
 images/
 main.c
 main.h
 sound/
 $> svn ls $SVNROOT/depot/sound
 1.ogg
 2.ogg

== Obtenir une copie de travail ==

La copie de travail est un « exemplaire » local du dépôt, à laquelle on apporte les modifications voulues avant de les propager dans le dépôt. Cette copie de travail est indispensable : il n'est en aucun cas possible d'apporter des modifications directement dans les fichiers du dépôt.

L'opération consistant à récupérer une copie de travail est le « checkout », abrégé « co ». Pour récupérer une copie locale du dépôt $SVNROOT/depot dans le répertoire local <tt>depot</tt>, utiliser la commande suivante :
 $> svn co $SVNROOT/depot
Si l'on veut nommer la racine de la copie de travail autrement que le dépôt (par exemple « copie_de_travail »), on peut utiliser :
 $> svn co $SVNROOT/depot copie_de_travail

== Modifications locales ==

Pour modifier un fichier de la copie locale, il suffit de l'éditer normalement. Subversion détectera automatiquement les fichiers qui ont été modifiés. En revanche, si l'on veut créer un nouveau fichier, déplacer, supprimer un fichier du dépôt, il est nécessaire d'utiliser des commandes spécifiques de subversion :
* <tt>svn add fichier</tt> : le fichier <tt>fichier</tt> sera ajouté au dépôt lors de la prochaine propagation. Le fichier doit exister dans la copie de travail (Subversion ne le créera pas automatiquement).
* <tt>svn mv fichier nouvel/emplacement</tt> : déplace le fichier <tt>fichier</tt> vers <tt>nouvel/emplacement</tt> (le comportement est le même que la commande système '''mv'''), à la fois dans la copie de travail et dans le dépôt (lors de la propagation des modifications).
* <tt>svn cp fichier autre/emplacement</tt> : même principe, mais le fichier est dupliqué.
* <tt>svn rm fichier</tt> : supprime le fichier <tt>fichier</tt> de la copie locale ; le fichier sera supprimé dans la révision propagée dans le dépôt.

== Autres commandes utiles ==

Ces commandes sont à exécuter dans le répertoire de la copie locale.
* <tt>svn info</tt> : affiche des informations concernant le dépôt. On peut aussi lancer <tt>svn info $SVNROOT/depot</tt> pour obtenir des informations sur un dépôt dont on n'a pas de copie de travail.
* <tt>svn log</tt> : affiche l'historique des révisions du dépôt, avec les commentaires associés. Il est également possible, come pour la commande précédente, de spécifier l'adresse d'un dépôt plutôt que d'exécuter la commande depuis la copie de travail.
* <tt>svn status</tt> (ou <tt>svn st</tt>) : affiche la liste des modifications apportées à la copie de travail par rapport à la révision récupérée du dépôt (sous la même forme que celle qui est présentée dans l'éditeur de texte lancé pour écrire le commentaire de révision, cf. ''[[#Commentaires de révisions|supra]]'').
* <tt>svn diff</tt> : affiche la liste détaillée des modification apportées à chaque fichier, sous la forme d'un ''diff'' entre la copie de travail et la révision initiale. On peut afficher les modifications apportées à un fichier en particulier : <tt>svn diff fichier</tt>

== Propager les modifications ==

L'opération consistant à propager dans le dépôt les modifications apportées à la copie de travail – autrement dit à créer une nouvelle révision semblable à la copie de travail – est le « commit » (abrégé « ci »). Depuis le répertoire de votre copie de travail, tapez simplement :
 $> svn ci

Comme décrit dans le paragraphe [[#Commentaires de révisions|Commentaires de révisions]], vous devez renseigner, d'une manière ou d'une autre, ledit commentaire.

Une fois la propagation terminée, vous pouvez exécuter la commande suivante pour mettre à jour les informations du dépôt (notamment le journal, qui n'est pas mis à jour automatiquement) :
 $> svn update