Control de versiones con Subversion - Control de versiones con Subversion

2.1. Instalar Subversion

Instalar subversion es sencillo tanto en UNIX como en Windows. Es un programa común en GNU/Linux, no ocupa más de unos pocos megabytes y todas las distribuciones lo incluyen. En Debian bastará con escribir

    
       $ aptitude install subversion
     
   

Método que se extrapola a todas las distribuciones con gestión automática de paquetes. Esta operación sirve para instalar tanto el cliente como el servidor. En Windows servidor y cliente suelen instalarse a parte. La mejor manera de instalar un servidor subversion es optar por la distribución SVN-1ClickSetup. El cliente más recomendable es Tortoise svn. Este cliente convierte el mismo explorer en un cliente Subversion, es realmente rápido y cómodo de usar.

2.2. Crear un repositorio subversion

Crear un repositorio en UNIX es tan sencillo como lo siguiente:

    
       guillem@pc:~$ svnadmin create repositories/test
       guillem@pc:~$ cd repositories
       guillem@pc:~/repositories$ ls
     
     
       test
     
     
       guillem@pc:~/repositories$ cd test
       guillem@pc:~/repositories/test$ ls
     
     
       conf  dav  db  format  hooks  locks  README.txt
     
   

Puede surgir la pregunta de por qué subversion ha creado estos directorios en vez de los ya descritos trunk, branches y tags. Esta duda proviene de no haber entendido la diferencia entre el repositorio y la copia de trabajo. Acabamos de crear un repositorio que no contiene ningun archivo sino una base de datos de todos los cambios realizados durante el tiempo. Los desarrolladores de Subversion saben que este error es muy común, por ello han puesto en este directorio el archivo README.txt This is a Subversion repository; use the 'svnadmin' tool to examine it. Do not add, delete, or modify files here unless you know how to avoid corrupting the repository. If the directory "db" contains a Berkeley DB environment, you may need to tweak the values in "db/DB_CONFIG" to match the requirements of your site. Visit http://subversion.tigris.org/ for more information.

Lo siguente es subir al repositorio los archivos sin versión del ordenador local. Recuérdese que aún no existe ninguna copia de trabajo. Para ello se usa el comando import

    
       guillem@pc:~$ svn import misarchivos \
                 file:///home/guillem/repositorios/test/misarchivos \
                 -m "Initial import of misarchivos"
     
     
       Adding         misarchivos/cversiones.xml
       Adding         misarchivos/figuras
       Adding         misarchivos/figuras/tortoise.png
       
       Committed revision 1.
     
   

Ahora el repositorio ya contiene una cantidad mínima de archivos suficiente para crear la copia de trabajo.

Es muy importante que el repositorio se encuentre en un ordenador con conexión permanente a internet. Aunque no se necesite ninguna conexión para trabajar con la copia de trabajo la mayoría de las acciones de Subversion requieren algún tipo de comunicación con el repositorio

2.3. Crear una copia de trabajo

Despues de crear el repositorio y llenarlo con documentos el siguiente paso es crear la copia de trabajo. En el control de versiónes generar una copia de trabajo a partir de una rama o la totalidad del árbol del repositorio recibe el nombre de check out.

    
       guillem@pc:~$ mkdir workspace
       guillem@pc:~$ cd workspace
     
   

Una vez creado el directorio que almacenará las copias de trabajo hay que escoger el método de comunicación con el repositorio. Los cuatro disponibles son:

2.4. Sesiones de control de versiones.

Ya se dispone de un repositorio y de una copia de trabajo. Sólo falta conocer las prácticas más comunes del control de versiones, es decir, cómo utilizar una copia de trabajo Subversion. El método será plantear sesiones ejemplo, con un principio y un final claros.

            
               guillem@pc:~/workspace/misarchivos$ svn update
             
           

            
               guillem@pc:~/workspace/misarchivos/figuras$ svn update
             
           

          svn commit
         

        
           guillem@pc:~/workspace$ svn help
         
         
           usage: svn "subcommand" [options] [args]
           Subversion command-line client, version 1.2.0.
           Type 'svn help "subcommand"' for help on a specific subcommand.
           
           Most subcommands take file and/or directory arguments, recursing
           on the directories.  If no arguments are supplied to such a
           command, it recurses on the current directory (inclusive) by default.
           
           Available subcommands:
           add
           blame (praise, annotate, ann)
           cat
           checkout (co)
           cleanup
           commit (ci)
           copy (cp)
           delete (del, remove, rm)
           diff (di)
           export
           help (?, h)
           import
           info
           list (ls)
           lock
           log
           merge
           mkdir
           move (mv, rename, ren)
           propdel (pdel, pd)
           propedit (pedit, pe)
           propget (pget, pg)
           proplist (plist, pl)
           propset (pset, ps)
           resolved
           revert
           status (stat, st)
           switch (sw)
           unlock
           update (up)
           
           Subversion is a tool for version control.  For additional information,
           see http://subversion.tigris.org/