CVS

La CVS est le moyen de développement choisi pour le BR.

Présentation de CVS

Principe de base

Le principe d'une CVS est de centraliser le développement en fournissant un moyen simple de programmer en groupe. Chaque développeur a chez lui une copie personnelle du projet sur laquelle il fait ses modifications. Quand il est satisfait, il valide ses modifications (commit) et tout le monde peut y avoir accès.

La CVS gère également des branches qui permette de continuer à développer sur une branche 'instable' pendant qu'on décide de 'releaser' une version stable.

Chaque projet est appelé un module.

Utilisation

Récupérer une copie locale

cvs -d $user$@gwennoz:/home/cvs co [-r $branche$] $module$

Cette commande récupère sur le serveur la dernière version du module dans la branche précisée (branche principale par défaut). La copie est stockée dans ./$module$/

Récupérer les modifications des autres

cvs up [-d] [$fichiers$]

Récupère la dernière copie des fichiers spécifiés. Le -d est nécessaire pour récupérer de nouveaux répertoires

Valider ses modifications

cvs ci [$fichiers$]

Cette commande envoie au serveur les fichiers modifiés. Si aucun conflit n'est détecté la modification est validée.

Il faut toujous updater la copie locale avant de commiter ses modifications.

Ajouter un fichier/répertoire

cvs add $fichiers$

Ajoute les fichiers spécifiés à la CVS. Les répertoires sont ajoutés immédiatement, par contre il faut commiter les fichiers ajoutés pour valider l'ajout.

Supprimer un fichier

cvs remove $fichiers$

Supprime un fichier du module. La suppression sera effective après un commit.

La copie locale doit être supprimée avant !!!

Créer une branche

cvs tag -b $branche$

Crée le branche spécifiée. Pour travailler sur cette branche, il faut faire un checkout de cette branche

Backporter

cvs up -j$version1$ -j$version2$ $fichier$
cvs ci -m 'Backport de $fichier$'

Effectue les modifications qu'il y a eu entre la version1 et la version2 sur fichier.

Attention à mettre version1 et version2 dans le bon sens, sinon on supprime les modifications au lieu de les appliquer.

Installation de la CVS sous Windows

TODO : remplir cette partie !!!

Modules présents sur la CVS

Cette partie n'a pas pour but d'être complète, mais elle doit tout de même donner une liste la plus complète possible des modules présents sur la CVS.

CVSROOT
arpwatch
bin-root
cocoaxnet -> xnet/cocoaxnet
config
config/etc
config-etc -> config/etc
docs
frankiz -> fankiz2
frankiz2
infobr
mxnet -> xnet/mxnet
news
news-bin -> news/bin
news-etc -> news/etc
news-public_html -> news/public_html
projet -> xshare/projet
qrezix -> xnet/qrezix
qrezix-plugins -> xnet/qrezix-plugins
qrezix2 -> xnet/qrezix2
siteeleves
test
web
xnet
xnet/cocoaxnet
xnet/cpanet
xnet/doc
xnet/mxnet
xnet/qrezix
xnet/qrezix-plugins
xnet/qrezix-plugins/smilix
xnet/qrezix-plugins/xplo
xnet/qrezix2
xnet/rexnet
xnet/xnet-tcp
xnet/xnetserver
xnet/xnetserver-old
xnetserver -> xnet/xnetserver
xnet-tcp -> xnet/xnet-tcp
xplo+
xplorateur
xshare

CVSROOT

Module d'administration de la CVS...
Ce module ne concerne que les administrateurs de la CVS.

arpwatch

arpwatch du BR, développé par Schmurtz (BR2002).

bin-root

Scripts d'administration, maintenance des serveurs
Ce module ne concerne que les roots.

config

Module regroupant tous les fichiers de configuration critiques.
Ce module ne concerne que les roots.

Ce module contient un sous-module :

• config/etc qui possède config-etc

docs (DEPRECATED)

Ancien module contenant tous les développement du BR visant à produire une documentation. Il contient les sous modules :

• faq
• faq-cvs
• faq-frankiz
• infobr
• old.infobr
• resal4nuls

frankiz2

Module CVS de la version dite 2 du site web des élèves. Ce modules contient l'intégralité du code de FrankizII.

infobr

Les infos BR de différents BR. On pourra noté en particulier la présence de l'infoBR du BR2003.

Il contient les sous-modules :

• InfoBR
• InfoBR2k3
• infobr

news

Contient tous les fichiers de configuration et les scripts des news.
Ce module ne concerne que les newsmestres.

siteeleves (DEPRECATED)

No comment...

test

No comment

web

Module du site externe du BR. Ce module a pour but de permettre le développement d'un site web qui présente le Binet Réseau, à la fois accessible en interne (pour les élèves présents sur le Résal) et en extérieur (en particulier les membres de Federez).

xnet

Le xNet est tout contenu là dedans. Il contient les sous modules suivant :

Modules mineurs :

• cpanet
• xnetserver (serveur compatible jusqu'à la version 3.0 du protocole xNet)
• xnetserver-old
• rexnet (nouvelle version du xnetserver par Ey...)
• doc : contient surtout la doc officielle du protocole xnet

cocoaxnet

Le client xNet conçu par les X99 pour une intégration parfaite dans MacOS.

qrezix

qRezix est le principal client xNet. Ce module contient différentes version du programme :

• branche principale : branche obsolète . Cette branche s'arrête à la version 1.3, elle a été freesée lors du passage du chat de qRezix en TCP.
• branche qrezix-tcp : branche de developpement. C'est devenu la vrai branche principale... Attention a toujours checkout qrezix sur cette branche pour avoir la dernière version de devel
• branche qrezix--release--1-6-2 : branche de release de qrezix 1.6.2
• branche qrezix--release--1-6-3 : branche de release de qrezix 1.6.3

qrezix-plugins

Contient les plugins pour qRezix. Les plugins actuellement présents sont :

• xplo (pour le partage et la recherche de fichiers)
• smilix (pour avoir des smileys dans le chat de qRezix)

qrezix2

Module censé accueillir le travaille de développement de la future version 2.x de qRezix.

xnet-tcp

Serveur xnet de prod. La dernière version est actuellement capable de gérer le protocole xNet version 4.0.

xplo+

Version du moteur de recherche (Xplorateur) codée par leolio avec un moteur d'indexation en C.

xplorateur

Modules qui contient l'xplorateur II.

• • Attention :** La version de prod actuelle a été modifiée depuis la version CVS (en particulier pour ce qui est de l'obtention de la liste des utilisateurs).

xshare (DEPRECATED)

Modules de l'ancienne interface des xshares

Administration de la CVS

Actuellement la CVS est divisée en deux principales parties :

• le cvs en ssh (dans /home/cvs) qui est utilisable par toutes les personnes qui sont dans le group cvs sur gwennoz
• la cvs en pserver qui fournit un accès public anonyme à une partie des modules en lecture seule.

CVS over SSH

Administration de la CVS

La CVS est gérée par le modules CVSROOT qui contient un certains nombre de données de configuration et d'utilitaires. Les plus notables sont :

La gestion des pseudo-modules avec le fichier modules. Ce fichier permet d'associer un nom de module à une autre module. Par exemple, on a un programme blah dans le grouope chombier (donc le module pour blah c'est chombier/blah), on peut définir un module blah facilement accessible dans ce fichier modules :

#=================================
# blah pseudo modules
#=================================
blah                 chombier/blah

Le mail de commit est géré un un utilitaire très complet et produisant des mails propres et lisibles appellé 'activitymail'. On ne rentrera pas en détail dans le fonctionnement de ce script perl, mais ce qu'il faut savoir c'est :

• le script doit être appelé par les fichier commitinfo, loginfo, ... pour que la gestion des logs soit faite par activitymail
• activitymail peut-être modifié directement dans /home/cvs/CVSROOT/activitymail... même si ce n'est à faire qu'en cas d'extrême nécessité, c'est pratique pour réparer le script après un commit foireux...

Gestion des droits

Il est facile de limiter l'accès à certains modules uniquement à certaines personnes. Il suffit de donner des droits spécifiques sur le répertoire de ce module. Ceci permet par exemple de rendre le module de configuration des serveurs accessible uniquement aux root (membres du group adm en fait), le modules d'administration du serveur de news uniquement aux newsmestres (groupe news), ou encore le module CVSROOT uniquement aux membres du groupe cvsadmin.

Actuellement les modules sur lesquels il y a des limitations d'accès sont :

CVSROOT -> cvsadmin
bin-root -> adm
config -> adm
news -> news

Anoncvs

Configurer et utiliser le pserver

Le pserver est géré par cvsd (disponible sur l'arbre gentoo). Actuellement il utilise une configuration relativement peu sécurisée, mais qui a le mérite de marcher. La configuration se trouve dans /etc/cvsd/cvsd.conf. Les principales données de configuration actuelle sont :

Uid root
Gid root
Listen * 2401
Repos /home/anoncvs

Le pserver n'est configuré que pour un compte anonyme, dont l'utilisation se fait en 2 temps :

• se logguer (mot de passe vide) sur la CVS avec:

cvs -d :pserver:anoncvs@gwennoz:/home/cvs login

• télécharger les sources :

cvs -d :pserver:anoncvs@gwennoz:/home/cvs co [comme d'hab]

Administrer les modules de l'anoncvs

Pour mettre un module dans l'anoncvs, il suffit de créer un lien symbolique depuis le module de la CVS normale vers /home/anoncvs.

Les modules actuellement présents sont :

faq-frankiz
infoBR (InfoBR2k3)
mxnet
qrezix
qrezix-plugins
xnetserver (ancien serveur)
xnet/cocoaxnet
xnet/doc
xnet/qrezix
xnet/qrezix-plugins
xnet/xnetserver (ancien serveur)

---

Retour : Accueil