|
|
| (9 versions intermédiaires par 3 utilisateurs non affichées) |
| Ligne 1 : |
Ligne 1 : |
| <div style="border: 1px solid #6f8f9f; padding: .2em .5em .2em .5em; background-color: #EAF5FB">
| | {{Archive|Le BR a migré vers [[Git]] depuis l'écriture de cet article.}} |
| '''Page obsolète !'''
| |
|
| |
|
| Le BR a migré vers [[Subversion]] le 27 juin 2005.
| | La CVS était le moyen de développement choisi pour le BR. |
| </div>
| |
|
| |
|
|
| |
| La CVS est le moyen de développement choisi pour le BR.
| |
|
| |
|
| == Présentation de CVS == | | == Présentation de CVS == |
| Ligne 63 : |
Ligne 59 : |
|
| |
|
| TODO : remplir cette partie !!! | | TODO : remplir cette partie !!! |
|
| |
| == Modules présents sur la CVS ==
| |
| Cette partie n'a pas pour but d'être exhaustive, 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
| |
|
| |
| {| border=1 cellspacing=0 cellpadding=5
| |
| ! Module
| |
| ! Détails
| |
| |-
| |
| | valign=top | CVSROOT
| |
| |
| |
| Module d'administration de la CVS...<br />
| |
| Ce module ne concerne que les administrateurs de la CVS.
| |
| |-
| |
| | valign=top | arpwatch
| |
| | Arpwatch du BR, développé par Schmurtz ([[BR2002]]).
| |
| |-
| |
| | valign=top | bin-root
| |
| |
| |
| Scripts d'administration, maintenance des serveurs<br />
| |
| Ce module ne concerne que les roots.
| |
| |-
| |
| | valign=top | config
| |
| |
| |
| Module regroupant tous les fichiers de configuration critiques.<br />
| |
| Ce module ne concerne que les roots.
| |
|
| |
| Ce module contient un sous-module :
| |
| * ''config/etc'' qui possède un alias ''config-etc''
| |
| |-
| |
| | valign=top | 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''
| |
| |-
| |
| | valign=top | frankiz2
| |
| |
| |
| Module CVS de la version dite 2 du site web des élèves. Ce module contient l'intégralité du code de [[FrankizII]].
| |
| |-
| |
| | valign=top | infobr
| |
| |
| |
| Les infos BR de différents BR. On pourra noter en particulier la présence de l'infoBR du [[BR2003]].
| |
|
| |
| Il contient les sous-modules :
| |
| * ''InfoBR''
| |
| * ''InfoBR2k3''
| |
| * ''infobr''
| |
| |-
| |
| | valign=top | news
| |
| |
| |
| Contient tous les fichiers de configuration et les scripts des news.<br />
| |
| Ce module ne concerne que les newsmestres.
| |
| |-
| |
| | valign=top | siteeleves (DEPRECATED)
| |
| |
| |
| No comment...
| |
| |-
| |
| | valign=top | test
| |
| |
| |
| No comment
| |
| |-
| |
| | valign=top | 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).
| |
| |-
| |
| | valign=top | xnet
| |
| |
| |
| Ce module regroupe tout ce qui concerne [[xNet]]. 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é freezée lors du passage du chat de [[qRezix]] en TCP.
| |
| * branche ''qrezix-tcp'' : '''branche de developpement'''. C'est devenu la vraie branche principale... Attention a toujours faire un checkout de 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 travail de développement de la future version 2.x de [[qRezix]].
| |
|
| |
| '''xnet-tcp'''
| |
| Serveur xnet de prod.
| |
| |-
| |
| | valign=top | xplo+
| |
| |
| |
| Version du moteur de recherche ''Xplorateur'' codée par leolio avec un moteur d'indexation en C.
| |
| |-
| |
| | valign=top | xplorateur
| |
| |
| |
| Moteur d'indexation des FTP et de recherche ''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).
| |
| |-
| |
| | valign=top | xshare (DEPRECATED)
| |
| |
| |
| Modules de l'ancienne interface des X-shares.
| |
| |}
| |
|
| |
| == 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 cvsadmin
| |
| 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)
| |
| xplorateur
| |
 |
Article archivé.
Le BR a migré vers Git depuis l'écriture de cet article. |
|
La CVS était 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 !!!
