CVS

De Guía Ubuntu
Saltar a: navegación, buscar

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
Nota clasica.png 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
Nota clasica.png 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}
Nota clasica.png 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>

Ver también

Aplicaciones similares

Enlaces externos

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