CVS

2008-02-24T00:41:32Z

TaracTalib: ouousitoure

elcnaba
{{INDdcha}}
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 [[aÃ±adir aplicaciones|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|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|Esto no pasarÃa si tuviÃ©ramos el fichero '''cvswrappers''' correctamente configurado}}

== Trabajar con CVS ==

[[Imagen:TkCVS.jpg|thumb|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 [[AÃ±adir aplicaciones|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 --cvs %{sVv} --diff --full

El programa que envÃa los correos lo podemos encontrar [http://www.infodrom.org/Infodrom/tools/cvs-mailcommit.html aquÃ]. 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 ==

* [[CVSTrac]]

=== Aplicaciones similares ===

* [[Subversion]]
* [[:CategorÃa:ProgramaciÃ³n|Ver mÃ¡s en la categorÃa ''ProgramaciÃ³n'']]

== Enlaces externos ==

{{Wikipedia}}
{{Wikilibros|Tutorial de uso de CVS}}
* [http://www.linux.ie/articles/tutorials/cvs.php linux.ie :: Getting Started with CVS] {{en}}
* [http://www.cvstrac.org/ Sitio web oficial de CVSTrac] {{en}}
* [http://www.sanchivi.com/cm/cvspermissions/ CVSPermissions] {{en}}
* [http://www.ossp.org/pkg/tool/shiela/ OSSP shiela: CVS Access Control and Logging] {{en}}
* [http://ali.as/devel/cvsmonitor/ Sitio web oficial de CVS Monitor] {{en}}
* [http://www.linux.ie/articles/tutorials/managingaccesswithcvs.php Managing Access with CVS] {{en}}

[[CategorÃa:ProgramaciÃ³n]]

Guía Ubuntu - Contribuciones del usuario [es]

CVS