Présentation

Présentation

Association

Développeurs

Auteurs

Goodies

Contact

Actualité

Inscription

Connexion

Deconnexion

Trustzilla

Plan du site

Ressources

Documentation Linux

Blog de Trustonme

Astuces

Scripts

Captures d'écrans

Livre d'or

TrustBook

Système

Gestionnaires de boot

Notions avancées

Le shell

Système

Administration

Compilation du noyau

Unix, GNU et Hurd

Systèmes de fichiers

Notions avancées

Validation

XHTML

CSS

1. Qu'est-ce que CVS, à quoi ça sert ? 2. Installation du client cvs 3. CVS côté client 3.1 Exemple d'utilisation classique 3.2 Commandes usuelles 3.3 Les conflits 3.4 CVS avancé 4. CVS côté serveur 5. Interfaces graphiques

Utilisation de CVS

1. Qu'est-ce que CVS, à quoi ça sert ?

CVS signifie Concurrent Versions System. C'est un utilitaire qui facilite le développement de projet en équipe, en conservant l'historique des modifications apportées à chaque fichier. Il travaille essentiellement sur des fichiers textes, c'est-à-dire qu'il ne sert à rien si vous travaillez sur des images ou sur des fichiers compressés. Cependant, il peut être très utile pour les projet de programmation (C, JAVA, HTML, ...), de rédaction (au format texte, donc pas de .doc), et tous les fichiers XML.

2. Installation du client cvs

CVS est surement inclu dans les packages de votre distribution. Pour les inconditionnels des sources, vous pouvez le télécharger sur www.cvshome.org.

3. CVS côté client

3.1 Exemple d'utilisation classique

Le mieux est d'étudier un cas concret (le nom du serveur est fictif).

Récupération du projet

Tout d'abord, configurez les variables de cvs (à mettre éventuellement dans le ~/.bashrc ou ~/.bash_profile). Par exemple :

export CVSROOT=morgoth@cvs.creatta.com:/var/cvs/cvsroot
export CVS_RSH=ssh
export CVSEDITOR=vim

Fermez puis relancez votre terminal afin que ce dernier lise ces variables. Ensuite, récupérez une copie de travail du projet. Par exemple : Notez le "U" devant le nom du fichier. Cela signifie mis-à-jour (Update).

Modifications

Vous pouvez faire ensuite des modifications comme vous le souhaitez dans le dossier (ici CreatTA_java). Par contre, ne modifiez pas les fichiers inclus dans les répertoires CVS. Ils sont nécessaires au bon fonctionnement de CVS. Il vous faut maintenant valider ces modifications sur le serveur. ou CVS vérifie que personne n'a modifié le fichier depuis que vous l'avez récupéré, et ajoute vos modifications en incrémentant le numéro de version du fichier. En cas de conflit, voyez plus bas. CVS vous demande de remplir un petit message expliquant vos modifications. N'oubliez pas de sauver ce message. Ici, tout s'est bien passé. Si on veut ensuite récupérer toutes les dernières versions des fichiers : Ici, tout est à jour, donc aucun fichier n'est récupéré.

3.2 Commandes usuelles

Récupèrer les derniers fichiers du projet dans un dossier du même nom : Valider les changements effectués : Récupèrer la dernière version du fichier, en fusionnant éventuellement avec vos modifications (voir Les conflits) : Ajouter le fichier ou le répertoire au dépot. Un "commit" est nécessaire pour valider l'ajout : Retirer du dépot un fichier ou un répertoire vide : Lister l'ensemble des modifications effectuées sur le fichier :

3.3 Les conflits

En utilisant CVS à plusieurs développeurs, des conflits peuvent apparaitre. Il faut pour cela comprendre un peu comment fonctionne CVS. Quand vous récupérez un ficher (cvs checkout), CVS mémorise le numéro de version du fichier à ce moment. Disons qu'il s'agit de la version 1.5. Un autre utilisateur récupère cette version, fait des modifications, et les valide (cvs commit). La version sur le serveur devient 1.6. De votre côté, vous faites des modifications sur ce même fichier, et vous tentez de les valider (cvs commit). CVS compare la version que vous aviez récupérée (1.5) et la version courante (1.6) : il sait que quelqu'un a modifié le fichier entre-temps ; il y a conflit, et donc il refuse de valider les changements. La solution consiste à fusionner les modifications. Pour cela, faîtes un cvs update nom du fichier. Vous devriez voir un M devant votre fichier (M pour merge = fusionné). Éditez maintenant le fichier et regardez si la fusion s'est bien passée. Si vous n'aviez pas édité les même parties du fichier, il ne devrait pas y avoir de problème. En revanche, si vous avez touché à la même ligne, CVS ne sait pas quoi faire, et vous demande de corriger manuellement. Ces conflits "graves" sont signalés dans le fichier par des lignes du style "CVS>>>>>>>>>>>>>>>>>>>>>>>>>>>>>". Réparez donc ces conflits, retirez les lignes ajoutées par CVS, sauvez et validez (cvs commit). Normalement, tout devrait bien se passer, et le fichier devrait obtenir le numéro de version 1.7. Sauf que quelqu'un a pu encore modifier le fichier pendant que vous faisiez la fusion... C'est pourquoi il faut éviter les conflits comme la peste, et éviter de travailler sur les mêmes parties d'un fichier. Il faut donc communiquer entre développeurs, ce que ne permet pas CVS.

3.4 CVS avancé

Les branches et les révisions.

4. CVS côté serveur

Il existe plusieurs façon de créer et d'accéder à un dépot CVS. Je n'en aborderai que trois : le dépot local, CVS avec SSH et CVS avec :pserver.

Le dépot local

Un dépot local peut être utile si vous travaillez seul sur un projet, mais que vous souhaitez utiliser CVS pour conserver l'historique de vos modifications. Création du dépot : Configuration des variables locales : Initialisation du dépot : Il faut ensuite ajuster les droits afin que les utilisateurs aient le droit de lire ET d'écrire dans le dépot. Pour accéder à votre dépot, définissez CVSROOT :

Accès SSH

L'accès à CVS par SSH est le seul moyen sécurisé pour autoriser des modifications à distance sur votre dépôt. Il suffit de créer le dépot comme indiqué ci-dessus, puis de renseigner les variables CVSROOT et CVS_RSH : En remplaçant "morgoth" par votre login ssh, et "Angband.com" par votre serveur.

Accès :pserver

L'accès par :pserver permet d'autoriser des personnes à se connecter de manière anonyme en lecture seule à votre dépôt. Cette méthode est utilisée par un grand nombre de projets libres. Tout d'abord, vous devez vous assurer d'avoir un compte anonymous (par exemple) et de lui autoriser l'accès en lecture à votre dépôt CVS. Pour ce faire, tapez dans un terminal : Maintenant, il ne vous reste plus qu'à activer le service :pserver et à le configurer.

• Pour Mandriva : Vous n'avez rien à faire, ou presque. Tout d'abord, vérifiez que le fichier /etc/cvs/cvs.conf contient bien : CVS_REPOS="/var/cvs/cvsroot" (ou autre si vous n'avez pas choisi ce répertoire). Ensuite, activez :pserver en éditant le fichier /etc/xinetd.d/cvs et en mettant disable = no. Ensuite, un petit redémarrage de xinetd :
  # service xinetd restart
• Pour les autres : Ajoutez le service à xinetd (si il n'existe pas déjà) :
  # cat >> /etc/xinetd.conf << "EOF" service cvspserver { port = 2401 socket_type = stream protocol = tcp wait = no user = root passenv = PATH server = /usr/bin/cvs server_args = -f --allow-root=/var/cvs/cvsroot pserver } EOF
  Puis forcez xinetd à relire sa configuration par : # killall -HUP xinetd

Maintenant, pour accéder de manière anonyme à votre dépôt, il suffit de taper la commande suivante (ajustée à votre configuration) :

Ajouter un nouveau projet

Pour ajouter un nouveau projet au dépot CVS, allez dans le répertoire qui contient les sources de votre projet : Où "projet-XYZ" sera le nom de votre module, et "initial" le tag.

5. Interfaces graphiques

Il existe de nombreuses interfaces graphiques pour cvs. Citons TkCvs (que je n'ai jamais essayé), Cervisia (l'interface CVS de KDE), et enfin WinCVS (sous Windows). CVS s'intègre dans de nombreux outils de développement, comme Eclipse ou Netbeans.