CVS

Contenido

1 InstalaciÃÂÃÂ³n
2 ConfiguraciÃÂÃÂ³n de un repositorio
3 PersonalizaciÃÂÃÂ³n del repositorio
4 AÃÂÃÂ±adir un proyecto al repositorio
5 Binarios importados sin '-kb'
6 Trabajar con CVS
7 NotificaciÃÂÃÂ³n de los commits
8 Hacer una copia de seguridad
9 Ver tambiÃÂÃÂ©n
- 9.1 Aplicaciones similares
10 Enlaces externos

El Sistema de Control de Versiones (CVS) permite que varios programadores trabajen de forma colaborativa en un mismo proyecto llevando un control de las versiones de los ficheros. De esta forma se permiten cambios concurrentes en un mismo fichero sin perder lo cambios realizados. Si usas o quieres usar esta herramienta se recomienda que pruebes CVSTrac.

InstalaciÃÂÃÂ³n

El programa viene en el paquete cvs que podemos instalar los repositorios oficiales de Ubuntu.

ConfiguraciÃÂÃÂ³n de un repositorio

Vamos a tener cada proyecto en un repositorio separado, que es lo suyo para tener un control mÃÂÃÂ¡s fino sobre cada uno de los distintos repositorios. Es mejor asÃÂÃÂ por el tema de usuarios, permisos y configuraciones varias. Todos estos repositorios los vamos a crear dentro del directorio /var/lib/repositorio/, por ejemplo, para tenerlos juntos y facilitar el tema de la copia de seguridad.

Como buena prÃÂÃÂ¡ctica es aconsejable tener un usuario cvs que serÃÂÃÂ¡ el propietario de los ficheros:

$ adduser cvs
$ chown cvs:cvs -R /var/lib/repositorio

Una vez declaradas estas premisas procedemos a la inicializaciÃÂÃÂ³n del repositorio que albergarÃÂÃÂ¡ un hipotÃÂÃÂ©tico llamado tuxitron. Estas tareas de instalaciÃÂÃÂ³n las haremos como root:

$ cvs -d /var/lib/repositorio/tuxitron init

Para que todos los usuarios del grupo cvs tengan permisos para trabajar con el repositorio, hacemos que todos los ficheros del reciÃÂÃÂ©n creado repositorio pertenezcan a ese grupo:

$ chgrp cvs /var/lib/repositorio/tuxitron -R

Ahora le tenemos que indicar al CVS que puede disponer del nuevo repositorio. Si usamos el superdemonio xinetd tendremos que crear el fichero:

$ gedit /etc/xinetd.d/cvs

y aÃÂÃÂ±adir el nuevo repositorio:

--allow-root=/var/lib/repositorio/tuxitron

Al final debe quedar una cosa asÃÂÃÂ:

service cvspserver
{
        socket_type = stream
        protocol = tcp
        user = root
        group = cvs
        server = /usr/bin/cvs
        server_args = -f --allow-root=/var/lib/repositorio/perico --allow-root=/var/lib/repositorio/tuxitron pserver
        wait = no
        disable = no
}

Y reiniciamos el superservidor para que los cambios surtan efecto:

$ /etc/init.d/xinetd reload

PersonalizaciÃÂÃÂ³n del repositorio

Antes de empezar a poner cÃÂÃÂ³digo en el repositorio hay algunas cosas por hacer que nos facilitarÃÂÃÂ¡n luego el proceso de desarrollo. En el repositorio que acabamos de crear existe un directorio CVSROOT que contiene ficheros de carÃÂÃÂ¡cter administrativo, esto es, que nos permiten personalizar el comportamiento del CVS. Veamos algunos de ellos para el caso de programar en Java:

cvsignore: Indica patrones de ficheros a ignorar por el CVS. Estos ficheros no se podrÃÂÃÂ¡n aÃÂÃÂ±adir al repositorio. Ejemplo:

*.class
*.war
*.ear

cvswrappers: Especifica cÃÂÃÂ³mo serÃÂÃÂ¡n gestionados determinados ficheros. Sirve para indicar quÃÂÃÂ© ficheros son binarios. Ejemplo:

*.gif -k 'b'
*.jpg -k 'b'
*.png -k 'b'
*.jar -k 'b'
*.swf -k 'b'

writers: Listado de usuarios que tienen permisos de escritura en el repositorio. Ejemplo:

fulanito
menganito
zutanito

passwd: Nombre de los usuarios junto con sus correspondientes passwords. Cada lÃÂÃÂnea estÃÂÃÂ¡ compuesta de nombre del usuario, password codificado y correspondencia con usuario local. Ejemplo:

fulanito:********:cvs
menganito:*********:cvs
zutanito:*********:cvs

Para encriptar los passwords puedes usar este programa en Perl, al que le pasas el password en plano como parÃÂÃÂ¡metro y lo devuelve convenientemente codificado:

<perl>

#!/usr/bin/perl

srand (time());
my $randletter = "(int (rand (26)) + (int (rand (1) + .5) % 2 ?  65 : 97))";
my $salt = sprintf ("%c%c", eval $randletter, eval $randletter);
my $plaintext = shift;
my $crypttext = crypt ($plaintext, $salt);

print "${crypttext}\n";

</perl>

Estos ficheros no se editan directamente en el repositorio, a excepciÃÂÃÂ³n del passwd por motivos de seguridad, sino que deberemos hacer un checkout del directorio CVSROOT del repositorio para modificarlos y luego el commit correspondiente. Los ficheros cvsignore y writers tendrÃÂÃÂ¡s que crearlos y aÃÂÃÂ±adirlos al repositorio.

AÃÂÃÂ±adir un proyecto al repositorio

Una vez tengamos creado el repositorio tenemos que crear un proyecto. En los proyectos simples habrÃÂÃÂ¡ un sÃÂÃÂ³lo proyecto por repositorio, pero en los mÃÂÃÂ¡s complejos puede haber varios proyectos relacionados en un mismo repositorio. En GNOME, por ejemplo, hay un repositorio y cada uno de los componentes de GNOME es un proyecto (Evolution, Nautilus, Evince, etc.).

Lo que haremos en importar lo que tenemos creando un proyecto en el repositorio, de esta forma pondremos disponible el cÃÂÃÂ³digo para que otra gente se pueda incluir en el proceso de desarrollo. Se usa el comando import del CVS. Es importante ejecutar este comando desde el directorio donde tengamos las fuentes para importar. TambiÃÂÃÂ©n es fundamental establecer la variable de entorno CVSROOT que le indicarÃÂÃÂ¡ al cliente CVS donde estÃÂÃÂ¡ el repositorio.

$ export CVSROOT=/var/lib/repositorio/tuxitron

La sintaxis del comando de importaciÃÂÃÂ³n es la siguiente:

$ cvs import -m "comentario" <proyecto> <etiqueta_vendedor> <etiqueta_version>

Los dos ÃÂÃÂºltimos parÃÂÃÂ¡metros tienen poca importancia, de modo que puedes sustituirlos por tu usuario y la palabra "inicio" mismo. Por ejemplo, si eres el usuario monkiki y el proyecto a importar se llama tuxitron la lÃÂÃÂnea de comandos serÃÂÃÂa:

$ cvs import -m "ImportaciÃÂÃÂ³n inicial" tuxitron monkiki inicio

Si vas a usar CVSTrac en lugar de importar todo el proyecto, importa un directorio vacÃÂÃÂo o uno que contenga un fichero de texto sin importancia (del estilo de leeme.txt) y haz un commit del resto de los ficheros. Los ficheros importados no aparecen en el navegador web de CVS.

Binarios importados sin '-kb'

Si accidentalmente aÃÂÃÂ±ades un fichero binario sin la opciÃÂÃÂ³n '-kb', puedes usar el comando cvs admin para arreglarlo. Por ejemplo:

$ cvs add -m "Imagen de prueba" imagen.gif
$ cvs ci -m "Enviamos la imagen no marcada como binario" image.gif

Ahora vamos a decirle que es un fichero binario:

$ cvs admin -kb imagen.gif
$ cvs update -A imagen.gif

Esto no pasarÃÂÃÂa si tuviÃÂÃÂ©ramos el fichero cvswrappers correctamente configurado

Trabajar con CVS

TkCVS es un magnÃÂÃÂfico cliente grÃÂÃÂ¡fico para CVS.

La lÃÂÃÂnea de comandos admite gran cantidad de comandos y opciones. En la nomenclatura de CVS, los comandos son parÃÂÃÂ¡metros funcionales de CVS. En lugar de tener varios ejecutables, uno para hacer checkout, otro para checkin, otro para status... tiene uno sÃÂÃÂ³lo llamado cvs que admite todos estos modos de funcionamiento. Veamos los principales:

checkout: Saca el fichero del repositorio y lo almacena localmente para poder trabajar con ÃÂÃÂ©l.
checkin: Una vez realizados los cambios, volcamos el fichero al repositorio donde estarÃÂÃÂ¡ disponible para el resto de desarrolladores.
status: Indica el estado actual del fichero.
log: Saca un listado con las revisiones del fichero.

Pero lo mÃÂÃÂ¡s normal es que uses alguno de los clientes grÃÂÃÂ¡ficos que existen. Uno de los mejores, aunque no tenga buena apariencia, es TkCVS, el cual podemos instalar con el paquete tkcvs de los repositorios oficiales de Ubuntu.

NotificaciÃÂÃÂ³n de los commits

La configuraciÃÂÃÂ³n de un repositorio tambiÃÂÃÂ©n estÃÂÃÂ¡ sujeta al versionado. AsÃÂÃÂ que para aÃÂÃÂ±adir la opciÃÂÃÂ³n de notificaciÃÂÃÂ³n de correo de los commits tenemos que hacer un checkout del directorio especial CVSROOT.

$ cvs co CVSROOT

Dentro de ese directorio hay unos cuantos ficheros. El que nos interesa ahora es loginfo, al que tenemos que aÃÂÃÂ±adir la siguiente lÃÂÃÂnea:

DEFAULT /usr/bin/cvs-mailcommit --mailto direccion@correo.com --from direccion@correo.com --diff --full --root %r --dir %p %{sVv}

Para versiones de cvs anteriores a la 1.12.6, el formato es el siguiente:

DEFAULT /usr/bin/cvs-mailcommit --mailto direccion@correo.com --from direccion@correo.com --cvs %{sVv} --diff --full

El programa que envÃÂÃÂa los correos lo podemos encontrar aquÃÂÃÂ, aunque tambiÃÂÃÂ©n estÃÂÃÂ¡ en los repositorios de Ubuntu:

$ sudo aptitude install cvs-mailcommit

El parÃÂÃÂ¡metro mailto indica a quiÃÂÃÂ©n va destinado el correo. Podemos especificar varios mailto. Lo que yo hago es crear un alias en el servidor de correo y enviar el correo a ese alias. AsÃÂÃÂ puedo poner o quitar los usuarios de destino sin tocar este fichero de configuraciÃÂÃÂ³n.

Hacer una copia de seguridad

Veamos un ejemplo de cÃÂÃÂ³mo hacer una copia de seguridad de nuestro preciado repositorio de CVS. Simplemente lo que hace es:

Crea un archivo .tgz con el contenido del repositorio
EnvÃÂÃÂa el archivo a un servidor de backup
EnvÃÂÃÂa un correo al usuario root para avisarle del proceso

El script es bastante simple y puedes adaptarlo a tus necesidades sin gran esfuerzo.

<bash>

#!/bin/sh

CVS_ROOT="/var/lib/cvs"
TMP_MSG="/tmp/backup_cvs.tmp"
TMP_DATA="/root/Backup/CVS#$(date +%Y-%m-%d).tgz"

# Make backup
echo $TMP_DATA > $TMP_MSG
echo "==================================" >> $TMP_MSG
/bin/tar czf $TMP_DATA $CVS_ROOT 2>> $TMP_MSG

# Subimos todo al FTP de GIT
lftp -e "mput $TMP_DATA;quit" ftp://usuario:password@ftp.servidor.com/cvs

# Send mail
/bin/mail -s "CVS Backup" root < $TMP_MSG
/bin/rm $TMP_MSG

</bash>

CVSTrac

Aplicaciones similares

Enlaces externos

Wikipedia alberga un artículo enciclopédico sobre CVS. (en español)

Wikilibros alberga un libro sobre CVS. (en español)

linux.ie :: Getting Started with CVS (en inglés)
Sitio web oficial de CVSTrac (en inglés)
CVSPermissions (en inglés)
OSSP shiela: CVS Access Control and Logging (en inglés)
Sitio web oficial de CVS Monitor (en inglés)
Managing Access with CVS (en inglés)

CategorÃÂÃÂa:ProgramaciÃÂÃÂ³n

CVS

Contenido

InstalaciÃÂÃÂ³n

ConfiguraciÃÂÃÂ³n de un repositorio

PersonalizaciÃÂÃÂ³n del repositorio

AÃÂÃÂ±adir un proyecto al repositorio

Binarios importados sin '-kb'

Trabajar con CVS

NotificaciÃÂÃÂ³n de los commits

Hacer una copia de seguridad

Ver tambiÃÂÃÂ©n

Aplicaciones similares

Enlaces externos

Menú de navegación

Vistas

Herramientas personales

Navegación

Buscar

Herramientas

CVS

Contenido

InstalaciÃÂÃÂ³n

ConfiguraciÃÂÃÂ³n de un repositorio

PersonalizaciÃÂÃÂ³n del repositorio

AÃÂÃÂ±adir un proyecto al repositorio

Binarios importados sin '-kb'

Trabajar con CVS

NotificaciÃÂÃÂ³n de los commits

Hacer una copia de seguridad

Ver tambiÃÂÃÂ©n

Aplicaciones similares

Enlaces externos

Menú de navegación

Buscar

InstalaciÃÂÃÂ³n

ConfiguraciÃÂÃÂ³n de un repositorio

PersonalizaciÃÂÃÂ³n del repositorio

AÃÂÃÂ±adir un proyecto al repositorio

NotificaciÃÂÃÂ³n de los commits

Ver tambiÃÂÃÂ©n