Club LinuX Nord-Pas de Calais

3- Découverte de CVS

Yvonnick Esnault — 2004-04-19T14:45:46Z

CVS est le gestionnaire de version de fichiers le plus répandu. Voici une installation pas à pas, puis une introduction aux commandes de bases.

Récupération de SuperProduit

La récupération de SuperProduit s'effectue à l'aide de la commande : cvs checkout .

Dans mes manipulations ci-dessus, une erreur se situe au niveau de la commande :
- $mkdir mon_produit
et au niveau de ma réflexion sur le nom de mon produit...
Notre produit s'apellera SuperProduit

Pourquoi ?
Nous avons décidé d'appeler le produit SuperProduit, mais nous lui avons donner le répertoire mon_produit

Pas très logique n'est-ce pas !

Une seconde erreur s'est glissée... Si, si !
Elle corrige notre première erreur ! Oh !

Pourquoi (bis) ?
La seconde erreur (si cela en est une) a été d'effectuer la commande cvs import en étant dans le répertoire :
~/mondossiercvs/mon_produit$

Nous avons enregistré uniquement le fichier :
premier_fichier
dans la base cvs, et non pas le répertoire :
mon_produit contenant mon_fichier

Ceci dit, le nom de notre produit a été founi lors de la commande d'importation telle que :
yvo@raclette : /mondossiercvs/mon_produit$ cvs import -m "Enregistrement de Super Produit dans le cvs" SuperProduit Recup V0

La preuve par l'exemple :

yvo@raclette:~/mondossiercvs$ cvs checkout SuperProduit cvs checkout: Updating SuperProduit U SuperProduit/premier_fichier yvo@raclette:~/mondossiercvs$ ls mon_produit SuperProduit yvo@raclette:~/mondossiercvs$ cd mon_produit/ yvo@raclette:~/mondossiercvs/mon_produit$ ls premier_fichier yvo@raclette:~/mondossiercvs/mon_produit$ cd ../ yvo@raclette:~/mondossiercvs$ ls mon_produit SuperProduit yvo@raclette:~/mondossiercvs$ cd SuperProduit/ yvo@raclette:~/mondossiercvs/SuperProduit$ ls CVS premier_fichier yvo@raclette:~/mondossiercvs/SuperProduit$ cd ../ yvo@raclette:~/mondossiercvs$ ls mon_produit SuperProduit yvo@raclette:~/mondossiercvs$

Nous pouvons donc supprimer le répertoire mon_produit qui ne sert plus à rien ! Hop :

yvo@raclette:~/mondossiercvs$ rm -rf mon_produit/ yvo@raclette:~/mondossiercvs$

2- Découverte de CVS

Yvonnick Esnault — 2004-04-19T14:45:35Z

CVS est le gestionnaire de version de fichiers le plus répandu. Voici une installation pas à pas sur une debian, puis une introduction aux commandes de bases.

Création de la base

Une fois la variable CVSROOT renseignée, nous pouvons créer la base telle que :
yvo@raclette:~/mondossiercvs$ cvs init
Cette commande crée les fichiers d'administration de la base dans le répertoire CVSROOT (ici /var/lib/cvs).

(FIXME : Debian a déjà fait ce travail à notre place ?)

Notre produit
Dans cette article, il nous faut un produit avec lequel cvs sera utilisé. Notre produit s'apellera SuperProduit et sera créé par yvo dans le répertoire :
/mondossiercvs/mon_produit
pour la première fois. Ce produit comporte un fichier nommé premier_fichier dans lequel une ligne est inscrite : première ligne

Plus clairement, cela donne :

yvo@raclette:~/mondossiercvs$ mkdir mon_produit yvo@raclette:~/mondossiercvs$ cd mon_produit yvo@raclette:~/mondossiercvs/mon_produit$ echo "première ligne" > premier_fichier yvo@raclette:~/mondossiercvs/mon_produit$ cat premier_fichier première ligne yvo@raclette:~/mondossiercvs/mon_produit$

Enregistrement de notre produit dans la base CVS

Notre produit est créé dans notre répertoire local, mais n'est pas encore inscrit dans la base cvs.

Cette inscription est un import : nous importons des fichiers de notre répertoire local sur le serveur.

La commande est :

yvo@raclette:~/mondossiercvs/mon_produit$ cvs import -m "Enregistrement de Super Produit dans le cvs" SuperProduit Recup V0 N SuperProduit/premier_fichier No conflicts created by this import

Visiblement, il n'y a pas eu de problème lors de l'import.

L'option -m est suivie ici de "Enregistrement de Super Produit dans le cvs". Cette option permet de donner un message de description pour la version. Si -m n'est pas renseignée, un éditeur de texte se lance.

L'option Recup est le nom de la branche.
L'option V0 est le nom de version.

Je n'explique pas plus ces options ici, vous comprendrez mieux avec la commande cvs log dans les articles suivants...

1- Découverte de CVS

Yvonnick Esnault — 2004-04-19T14:45:21Z

CVS est le gestionnaire de version de fichiers le plus répandu. Voici une installation pas à pas, puis une introduction aux commandes de bases.

Installation

L'installation à partir du paquet debian est très simple :
#apt-get install cvs
Il nous est posé deux questions à l'installation :

- « Veuillez indiquer la liste des répertoires qui sont à la racine de vos entrepôts... ». Par défaut c'est /var/lib/cvs. On garde la valeur par défaut.

- Une seconde question est posée et semble plus compliquée : « Le pserver CVS est un mécanisme client-serveur qui peut être utilisé par CVS ... Faut-il activer le pserver CVS ? ». Ici, tout dépend de la méthode d'accès à la base choisie après. C'est peut-être mieux de répondre oui pour tester ce mode d'accès.

L'installation a bien créé le répertoire /var/lib/cvs, d'ailleurs :

# ls /var/lib/cvs/ CVSROOT

Il est conseillé de ne pas toucher directement aux fichiers cvs dans ce répertoire.

Permissions

Tous les fichiers qui seront soumis au versionnement seront donc dans le répertoire /var/liv/cvs. Il faut donc que tous les utilisateurs de cvs ait le droit de modifier les fichiers.

De plus, nous ramarquons que :

# ls -la /var/lib/cvs/ total 12 drwxrwsr-x 3 root src 4096 2004-03-30 21:33 . drwxr-xr-x 39 root root 4096 2004-03-30 21:33 .. drwxrwsr-x 3 root src 4096 2004-03-30 21:33 CVSROOT

Il faut donc rajouter les personnes utilisant cvs au groupe cvs tel que :

# sudo adduser yvo src Ajout de l'utilisateur yvo au groupe src... Fait.

Notre répertoire local
Commençons d'abord à créer un répertoire dans notre dossier personnel où nous mettrons notre copie de travail. C'est dans ce répertoire que nous travaillerons sur nos projets.

Pour être clair, j'indique toutes mes commandes :

yvo@raclette:~$ cd /home/yvo/ yvo@raclette:~$ mkdir mondossiercvs yvo@raclette:~$ cd mondossiercvs/ yvo@raclette:~/mondossiercvs$

Méthodes d'accès

Il existe plusieurs méthodes d'accès à une base cvs :
- accès direct.
- mode serveur (avec pserver).
- mode ssh.
- mode serveur kerberos et GSSAPI, que l'on ne verra pas dans cette article.

Sur mon serveur nommé raclette, j'ai mon compte yvo. La base est sur :
yvo@raclette:~$ ls /var/lib/cvs/.

Configuration pour un accès direct
Notre variable d'environnement CVSROOT s'exporte telle que :

$export CVSROOT=/var/lib/cvs

Configuration pour un accès pserver
Pour l'accès en mode pserver, il faut modifier les fichiers /etc/services et /etc/inetd.conf. Debian fait ces modifications tout seul !
Fichier /etc/services :

# cat {{/etc/services}} | grep cvs cvspserver 2401/tcp # CVS client/server operations cvspserver 2401/udp

Fichier /etc/inetd.conf :

#cat /etc/inetd.conf | grep cvs cvspserver stream tcp nowait root /usr/sbin/tcpd /usr/sbin/cvs-pserver

Notre variable s'exporte telle que :

$export CVSROOT :pserver:yvo@raclette:/var/lib/cvs

Configuration pour un accès ssh
J'oublie volontairement l'accès rsh en préférant le ssh.

$export CVSROOT :ext:yvo@raclette:/var/lib/cvs $export CVS_RSH ssh

C'est à partir de cette variable CVSROOT que nos commandes cvs pourront s'effectuer.

4- Découverte de CVS

Yvonnick Esnault — 2004-04-19T12:27:23Z

CVS est le gestionnaire de version de fichiers le plus répandu. Voici une installation pas à pas, puis une introduction aux commandes de bases.

Travaillons et Versionnons !

C'est bien beau tout çà, mais l'on a du travail ! Il faut rajouter le texte "je travaille sur la deuxième ligne" dans notre fichier premier_fichier.

yvo@raclette:~/mondossiercvs/SuperProduit$ echo "Je travaille sur la seconde ligne" >> premier_fichier yvo@raclette:~/mondossiercvs/SuperProduit$ cat premier_fichier première ligne Je travaille sur la seconde ligne yvo@raclette:~/mondossiercvs/SuperProduit$

Et comme nous sommes contents de notre travail, nous pouvons l'enregistrer dans la base cvs :

yvo@raclette:~/mondossiercvs/SuperProduit$ cvs commit -m "Travail sur la seconde ligne Ok" cvs commit: Examining . Checking in premier_fichier; /var/lib/cvs/SuperProduit/premier_fichier,v <-- premier_fichier new revision: 1.2; previous revision: 1.1 done yvo@raclette:~/mondossiercvs/SuperProduit$

Le résultat de la commande cvs commit est explicit. Cvs a trouvé des modifications au niveau du fichier premier_fichier et a incrémenté le numéro de version.

Comme pour la commande cvs import, l'option -m a permis de donner une description pour cette mise à jour.

CVS log, après travail

Re-exécutons la commande cvs log après le cvs commit :

yvo@raclette:~/mondossiercvs$ cvs log SuperProduit/ cvs log: Logging SuperProduit RCS file: /var/lib/cvs/SuperProduit/premier_fichier,v Working file: SuperProduit/premier_fichier head: 1.2 branch: locks: strict access list: symbolic names: V0: 1.1.1.1 Recup: 1.1.1 keyword substitution: kv total revisions: 3; selected revisions: 3 description: ---------------------------- revision 1.2 date: 2004/03/30 21:42:40; author: yvo; state: Exp; lines: +1 -1 Travail sur la seconde ligne Ok ---------------------------- revision 1.1 date: 2004/03/30 20:52:20; author: yvo; state: Exp; branches: 1.1.1; Initial revision ---------------------------- revision 1.1.1.1 date: 2004/03/30 20:52:20; author: yvo; state: Exp; lines: +0 -0 Enregistrement de Super Produit dans le cvs =============================================================================

Nous constatons que nous sommes toujours dans la même branche nommée Recup avec sa version V0.

De plus, par rapport au premier cvs log, un paragraphe est ajouté : revision 1.2. Il reprend bien la description donnée à l'aide de l'option -m.

CVS Status

La commande cvs status est utile pour voir l'état d'un fichier local par rapport à un fichier distant.

Exemple

yvo@raclette:~/mondossiercvs/SuperProduit$ cvs status premier_fichier =================================================================== File: premier_fichier Status: Up-to-date Working revision: 1.2 Tue Mar 30 21:40:40 2004 Repository revision: 1.2 /var/lib/cvs/SuperProduit/premier_fichier,v Sticky Tag: (none) Sticky Date: (none) Sticky Options: (none) yvo@raclette:~/mondossiercvs/SuperProduit$

Le status est ici Up-to-date, aucune modification est présente entre le fichier premier_fichier local et le fichier premier_fichier du serveur.

Modifions maintenant ce fichier :

yvo@raclette:~/mondossiercvs/SuperProduit$ echo "Troisième ligne" >> premier_fichier

puis relançons cvs status :

yvo@raclette:~/mondossiercvs/SuperProduit$ cvs status premier_fichier =================================================================== File: premier_fichier Status: Locally Modified Working revision: 1.2 Tue Mar 30 21:40:40 2004 Repository revision: 1.2 /var/lib/cvs/SuperProduit/premier_fichier,v Sticky Tag: (none) Sticky Date: (none) Sticky Options: (none) yvo@raclette:~/mondossiercvs/SuperProduit$

Le fichier est maintenant dans le statut Locally Modified, soit en français modifié localement. Logique non ? ;-)

Cvs diff

Comme le cvs status nous indique une différence, nous souhaitons la voir plus précisément :

yvo@raclette:~/mondossiercvs/SuperProduit$ cvs diff -r 1.2 premier_fichier Index: premier_fichier =================================================================== RCS file: /var/lib/cvs/SuperProduit/premier_fichier,v retrieving revision 1.2 diff -r1.2 premier_fichier 2a3 > Troisième ligne yvo@raclette:~/mondossiercvs/SuperProduit$

Nous voyons donc que la différence entre les deux fichiers se situe au niveau de la ligne 2-3 avec pour changement :
> Troisième ligne.

Création d'un patch

yvo@raclette:~/mondossiercvs$ cvs diff -u -r1.2 SuperProduit cvs diff: Diffing SuperProduit Index: SuperProduit/premier_fichier =================================================================== RCS file: /var/lib/cvs/SuperProduit/premier_fichier,v retrieving revision 1.2 diff -u -r1.2 premier_fichier --- a/SuperProduit/premier_fichier 30 Mar 2004 21:42:40 -0000 1.2 +++ b/SuperProduit/premier_fichier 30 Mar 2004 21:56:12 -0000 @@ -1,2 +1,3 @@ première ligne Je travaille sur la seconde ligne +Troisième ligne yvo@raclette:~/mondossiercvs$

Cvs update

Imaginons maintenant que nous sommes pas seuls à travailler sur SuperProduit. Des modifications à premier_fichier peuvent apparaître, il ne faut donc pas trop tarder à faire notre commit.
Mais au lieu de se heurter à des problèmes possibles lors du commit (votre collègue a modifié la même ligne), il est bon de mettre à jour notre fichier localement.
Cette mise à jour n'efface pas le travail que l'on a fait depuis le dernier commit ou checkout (ici, le travail en question est d'avoir rajouté la troisième ligne). Si toutefois un collègue a travaillé sur le fichier, cela est mise à jour dans notre répertoire local.

yvo@raclette:~/mondossiercvs/SuperProduit$ cvs update cvs update: Updating . M premier_fichier yvo@raclette:~/mondossiercvs/SuperProduit$

Apparement, pas de modification effectuée par un collègue ! ;-)

Stop !

Nous nous arrêtons là pour cette approche pas à pas de CVS. Vous trouverez d'autres Howto plus complets sur le web tels que :

-
http://www.idealx.org/doc/cvs.fr.html
-
http://www.loria.fr/cgi-bin/molli/wilma.cgi/doc

Le site officiel est http://www.cvshome.org/

- TortoiseCVS - Client graphique pour Ms Windows
http://www.tortoisecvs.org/
- Guide de l'utilisateur TortoiseCvs (en français)
href="http://cedric.babault.free.fr/TortoiseCVSDoc/UserGuide_fr.html#begin.whattortoisecvs"> http://cedric.babault.free.fr/TortoiseCVSDoc/UserGuide_fr.html