Avant-propos
L'exercice consiste à initialiser une base cvs, à y déposer un projet, proposé ici sous la forme d'une page html, puis à réaliser localement des modifications de cette page, afin de les prendre en compte par les commandes de cvs. Le texte de l'exercice est indiqué dans le contenu de la page html, que vous lisez actuellement. Elle est localisée intialement dans le répertoire
exemple_simple/depot/page.html
Créer la base CVS en local
La base CVS est créée en local, par exemple, sous le répertoire exemple_simple/base, qui appartient au login user sur la machine locale.
mkdir ~/exemple_simple/base
La base doit être initialisée avant toute opération, ce en pratique qui est fait par la commande cvs -d ~/exemple_simple/base init.
cvs -d ~/exemple_simple/base init
Dans ce cas, le répertoire ~/exemple_simple/base contient un sous-répertoire ~/exemple_simple/base/CVSROOT dans lequel se trouvent les fichiers de gestion de la base.
ls -l ~/exemple_simple/base
ls -l ~/exemple_simple/base/CVSROOT
Accès à la base CVS
L'accès à la base peut se faire de trois manières différentes. Le choix de la façon d'accéder à la base est défini par la variable d'environnement CVSROOT :
codiciel sur la machine locale sur laquelle se trouve la base et qui sera par la suite dénommé cvs.cnrs.fr, la variable d'environnement est donc CVSROOT=/home/codiciel/exemple_simple/base. Ceci est possible lorsque les fichiers sont installés sur un système de fichier réparti comme NFS. Lorsque ce n'est pas possible, la base CVS est installée sur une machine qui tient le rôle d'un serveur CVS et les autres machines accèdent à la base CVS en tant que clients du serveur.
user accède à la base par la variable d'environnement CVSROOT=:pserver:user@cvs.cnrs.fr:/home/codiciel/exemple_simple/base. Il n'est pas nécéssaire que tous les utilisateurs aient un compte sur la machine cvs.cnrs.fr, la gestion des mots de passe pouvant être gérée par la commande apache htpasswd. Pour plus d'information, se référer par exemple à la documentation de http://www.codiciel.fr.
CVSROOT=:ext:user@cvs.cnrs.fr:/home/codiciel/exemple_simple/base. Il faut donc que tous les utilisateurs aient un compte sur la machine cvs.cnrs.fr, et la variable CVSROOT diffère suivant les utilisateurs. Le protocole d'accès ssh est défini dans la variable CVS_RSH=ssh. C'est un accès sécurisé.
Ici, pour l'exercice, l'accès se fait en local. En bash :
export CVSROOT=~/exemple_simple/base
En csh ou tcsh :
setenv CVSROOT ~/exemple_simple/base
Dépôt d'un projet dans la base CVS
L'utilisateur user dispose sur la machine locale.cnrs.fr d'un projet page.html qu'il veut déposer dans la base CVS. Il doit choisir son mode d'accès à la base en définissant la variable CVSROOT et les autres variables d'envrionnement nécessaires sur locale.cnrs.fr. Le dépôt initial du projet s'effectue alors par la commande import :
cd ~/exemple_simple/depot
cvs import -m "depot initial" projet user v1_0
Dans la base CVS a été créé un module projet/ qui contient le fichier page.html,v où l'extension ,v indique qu'il s'agit bien d'une archive.
Récupérer une version de travail
Avant de poursuivre le développement de son projet page.html, l'utilisateur user doit récupérer une version de travail à partir de l'archive CVS. Ceci est réalisé par la commande checkout :
cd ~/exemple_simple
cvs checkout projet
Un répertoire projet/, contenant le fichier projet/page.html et un sous-répertoire projet/CVS est crééé par cette opération. Le développement du projet peut alors être réalisé avec les outils habituels en descendant dans le répertoire projet/ .
cd projet/
xemacs page.html
L'ensemble des modifications doit être réalisé à partir de cette copie de travail. Il ne faut jamais accéder directement aux fichiers de la base CVS, mais uniquement par l'intermédiaire des commandes de CVS.
Pour afficher un résumé des principales commandes de CVS, tapez dans le répertoire projet/
cat ../versions/page_commandes.html >> page.html