Capítulo 10. Gestión de información

Aquí esta un resumen de las herramientas de repositorio y compresión disponibles en un sistema Debian.

Aquí hay un resumen de las herramientas de copia y respaldo disponibles en el sistema Debian.

La copia de archivos con rsync(8) aporta muchas más funcionalidades que otros.

	Sugerencia
	La ejecución del archivo de órdenes bkup que se menciona en Sección 10.2.3, “Un archivo de órdenes para copiar la información de backup” con la opción «-gl» en cron(8) aporta una funcionalidad parecida a la de dumpfs en Plan9 para el archivo de datos estáticos.

	Sugerencia
	Las herramientas de sistemas de control de versiones (VCS) en Tabla 10.11, “Relación de herramientas de sistemas de control de versiones” pueden operar como herramientas de sincronización y copia en múltiples sentidos.

Aquí estan algunas manreas de archivar y desarchivar el contenido entero de un directorio «./origen» utilizando diferentes herramientas.

GNU tar(1):

$ tar -cvJf archive.tar.xz ./origen
$ tar -xvJf archive.tar.xz

Otra forma es como se muestra.

$ find ./origen -xdev -print0 | tar -cvJf archive.tar.xz --null -F -

cpio(1):

$ find ./origen -xdev -print0 | cpio -ov --null > archive.cpio; xz archive.cpio
$ zcat archive.cpio.xz | cpio -i

Aquí están diferentes maneras de copiar el contenido completo de un directotio «./origen» utilizando diferentes herramientas.

rsync(8):

# cd ./origen; rsync -aHAXSv . /destino
# cd ./origen; rsync -aHAXSv . usuario@equipo.dom:/destino

Puede utilizar la sintáxis de «barra «/« en el directorio origen«.

# rsync -aHAXSv ./origen/ /destino
# rsync -aHAXSv ./origen/ usuario@equipo.dom:/destino

Otra forma es como se muestra.

# cd ./origen; find . -print0 | rsync -aHAXSv0 --files-from=- . /destino
# cd ./origen; find . -print0 | rsync -aHAXSv0 --files-from=- . usuario@equipo.dom:/destino

GNU cp(1) y openSSH scp(1):

# cd ./origen; cp -a . /destino
# cd ./origen; scp -pr . usuario@equipo.dom:/destino

GNU tar(1):

# (cd ./origen && tar cf - . ) | (cd /destino && tar xvfp - )
# (cd ./origen && tar cf - . ) | ssh usuario@equipo.dom '(cd /destino && tar xvfp - )'

cpio(1):

# cd ./origen; find . -print0 | cpio -pvdm --null --sparse /destino

Puede sustituir «.» por «foo» para todos los ejemplos que contienen «.» para copiar archivos desde el directorio «./origen/foo» al directorio «/destino/foo».

Puede sustituir «.» por la ruta absoluta «/ruta/al/origen/foo» para todos los ejemplos que contienen «.» para eliminar «cd ./source;». La copia de estos archivos a diferentes ubicaciones depende de las herramientas utilizadas como se muestra.

	Sugerencia
	Rsync(8) y GNU cp(1) tiene la opción «-u» para no tener en cuenta los archivos que son más nuevos que los recibidos.

Un dispositivo de almacenamiento extraible puede pertenecer a uno de los siguientes tipos:

	Sugerencia
	Consulte Sección 9.8.1, “Cifrado de discos externos con dm-crypt/LUKS” para la compartición de información entre plataformas utilizando cifrado a nivel de dispositivo.

El sistema de archivos FAT esta soportado por casit todos los sistemas operativos modernos y es bastante útil para el intercambio de información por medio de un disco duro externo.

Cuando se formatea un disco duro externo con el sistemas de archivos FAT para compartir información entre diferentes platadormas, lo siguiente podrían ser las opciones más seguras.

Para compartir información con otros sistemas a través de internet, debería utilizar un servicio común. Aquí estan algunas pistas.

Aunque los sistemas de archivos montados a través de la red pueden ser útiles, estos pueden ser inseguros. Sus conexiones de red deben securizarse como se muestra.

Aquí estan una relación con las suites de copias de seguridad más importantes en un sistema Debian.

Las herramientas de copias de seguridad están especializadas en diferentes aspectos.

Para un sistema personal de escritorio Debian ejecutando «inestable», solo necesito proteger mis datos críticos personales. Reinstalo el sistema una vez al año siempre. Así es que no encuentro una razón para tener copias de seguridad del sistema completo o instalar una herramienta de copias de seguridad con todas las funcionalidades.

Utilizo un archivo de órdenes simple y lo grabo en un CD/DVD utilizando un interfaz gráfico de usuario. Aquí esta un ejemplo de un archivo de órdenes que realiza esta tarea.

#!/bin/sh -e
# Copyright (C) 2007-2008 Osamu Aoki <osamu@debian.org>, Public Domain
BUUID=1000; USER=osamu # UID and name of a user who accesses backup files
BUDIR=«/var/backups«
XDIR0=«.+/Mail|.+/Desktop«
XDIR1=«.+/\.thumbnails|.+/\.?Trash|.+/\.?[cC]ache|.+/\.gvfs|.+/sessions«
XDIR2=«.+/CVS|.+/\.git|.+/\.svn|.+/Downloads|.+/Archive|.+/Checkout|.+/tmp«
XSFX=«.+\.iso|.+\.tgz|.+\.tar\.gz|.+\.tar\.bz2|.+\.cpio|.+\.tmp|.+\.swp|.+~«
SIZE=«+99M«
DATE=$(date --utc +«%Y%m%d-%H%M«)
[ -d «$BUDIR« ] || mkdir -p «BUDIR«
umask 077
dpkg --get-selections \* > /var/lib/dpkg/dpkg-selections.list
debconf-get-selections > /var/cache/debconf/debconf-selections

{
find /etc /usr/local /opt /var/lib/dpkg/dpkg-selections.list \
     /var/cache/debconf/debconf-selections -xdev -print0
find /home/$USER /root -xdev -regextype posix-extended \
  -type d -regex «$XDIR0|$XDIR1« -prune -o -type f -regex «$XSFX« -prune -o \
  -type f -size  «$SIZE« -prune -o -print0
find /home/$USER/Mail/Inbox /home/$USER/Mail/Outbox -print0
find /home/$USER/Desktop  -xdev -regextype posix-extended \
  -type d -regex «$XDIR2« -prune -o -type f -regex «$XSFX« -prune -o \
  -type f -size  «$SIZE« -prune -o -print0
} | cpio -ov --null -O $BUDIR/BU$DATE.cpio
chown $BUUID $BUDIR/BU$DATE.cpio
touch $BUDIR/backup.stamp

Esto pretende ser un ejemplo de archivo de órdenes ejecutado como superusuario.

Espero que lo cambie y ejecute como se muestra.

Para el conjunto de información qeu se encuentra en árbol del directorio, la copia con «cp -a» proporciona una copia de respaldo normal.

Cuando se tiene gran cantidad de información estática que no se sobreescrite en un directorio como en el caso del directorio «/var/cache/apt/packages/», los enlaces duros con «cp -al» aporta una alternativa a la copia de respaldo normal consiguiendo un uso de espacio de disco eficiente.

Aquí esta una copia del archivo de órdenes, el cual he llamado bkup para las copias de respaldo. Este archivo de órdenes copia todos los archivos (no-CVS) contenidos por el directorio actual al directorio antiguo en el directorio padre o en el equipo remoto.

#!/bin/sh -e
# Copyright (C) 2007-2008 Osamu Aoki <osamu@debian.org>, Public Domain
fdot(){ find . -type d \( -iname «.?*« -o -iname «CVS« \) -prune -o -print0;}
fall(){ find . -print0;}
mkdircd(){ mkdir -p «$1«;chmod 700 «$1«;cd «$1«>/dev/null;}
FIND=«fdot«;OPT=«-a«;MODE=«CPIOP«;HOST=«localhost«;EXTP=«$(hostname -f)«
BKUP=«$(basename $(pwd)).bkup«;TIME=«$(date  +%Y%m%d-%H%M%S)«;BU=«$BKUP/$TIME«
while getopts gcCsStrlLaAxe:h:T f; do case $f in
g)  MODE=«GNUCP«;; # cp (GNU)
c)  MODE=«CPIOP«;; # cpio -p
C)  MODE=«CPIOI«;; # cpio -i
s)  MODE=«CPIOSSH«;; # cpio/ssh
t)  MODE=«TARSSH«;; # tar/ssh
r)  MODE=«RSYNCSSH«;; # rsync/ssh
l)  OPT=«-alv«;; # hardlink (GNU cp)
L)  OPT=«-av«;;  # copy (GNU cp)
a)  FIND=«fall«;; # find all
A)  FIND=«fdot«;; # find non CVS/ .???/
x)  set -x;; # trace
e)  EXTP=«${OPTARG}«;; # hostname -f
h)  HOST=«${OPTARG}«;; # user@remotehost.example.com
T)  MODE=«TEST«;; # test find mode
\?) echo «use -x for trace.«
esac; done
shift $(expr $OPTIND - 1)
if [ $# -gt 0 ]; then
  for x in $@; do cp $OPT $x $x.$TIME; done
elif [ $MODE = GNUCP ]; then
  mkdir -p «../$BU«;chmod 700 «../$BU«;cp $OPT . «../$BU/«
elif [ $MODE = CPIOP ]; then
  mkdir -p «../$BU«;chmod 700 «../$BU«
  $FIND|cpio --null --sparse -pvd ../$BU
elif [ $MODE = CPIOI ]; then
  $FIND|cpio -ov --null | ( mkdircd «../$BU«&&cpio -i )
elif [ $MODE = CPIOSSH ]; then
  $FIND|cpio -ov --null|ssh -C $HOST «( mkdircd \«$EXTP/$BU\«&&cpio -i )«
elif [ $MODE = TARSSH ]; then
  (tar cvf - . )|ssh -C $HOST «( mkdircd \«$EXTP/$BU\«&& tar xvfp - )«
elif [ $MODE = RSYNCSSH ]; then
  rsync -aHAXSv ./ «${HOST}:${EXTP}-${BKUP}-${TIME}«
else
  echo «Any other idea to backup?«
  $FIND |xargs -0 -n 1 echo
fi

Se trata de ejemplos de órdenes. Por favor lea el archivo de órdenes y modifiquelo usted mismo para adaptarlo a sus necesidades.

	Sugerencia
	Mantengo mi bkup en el directorio «/usr/local/bin/». Ejecuto la orden bkup sin ningún argumento cuando necesito una imagen temporal del directorio de trabajo.

	Sugerencia
	Para mantener un histórico de imágenes en un árbol de archivos o en un árbol de archivos de configuración, es fácil y eficiente en la utilización del espacio utilizar git(7) (see Sección 10.6.5, “Git para guardar el histórico de configuraciones”).

Aquí esta el significado de un código seguro.

Lo siguiente carga mi clave «1DD8D791» a un popular servidor de claves «hkp://keys.gnupg.net».

$ gpg --keyserver hkp://keys.gnupg.net --send-keys 1DD8D791

Un buen servidor de claves por defecto configurado en «~/.gnupg/gpg.conf» (o su ubicación antigua «~/.gnupg/options») contiene lo siguiente.

keyserver hkp://keys.gnupg.net

Lo siguiente obtiene las claves desconocidas del servidor de claves.

$ gpg --list-sigs --with-colons | grep '^sig.*\[User ID not found\]' |\
  cut -d ':' -f 5| sort | uniq | xargs gpg --recv-keys

Añada lo siguiente a «~/.muttrc» para mantener el lento el inicio automático de GnuPG, mientras permite usarlo pulsado «S» del menú principal.

macro index S «:toggle pgp_verify_sig\n«
set pgp_verify_sig=no

La extensión de gnupg le permite ejecutar GnuPG de forma transparente para archivos con la extensión «.gpg», «.asc» y «.ppg».

# aptitude install vim-scripts vim-addon-manager
$ vim-addons install gnupg

Los procedimientos siguientes extraen las diferencias entre dos archivos de código fuente y crea los archivos diff unificados «archivo.patch0» o «archivo.patch1» dependiendo de la ubicación del archivo.

$ diff -u archivo.antiguo archivo.nuevo > archivo.patch0
$ diff -u antiguo/archivo nuevo/archivo > archivo.patch1

Un archivo diff (también llamado un parche o un archivo de parche) se utiliza para enviar una actualización de un programa. Quien lo recibe aplica esta actualización a otro archivo como se muestra.

$ patch -p0 archivo < archivo.patch0
$ patch -p1 archivo < archivo.patch1

Si tiene tres versiones de un código fuente, puede realizar una mezcla de las tres de forma efectiva utilizandodiff3(1) como se muestra.

$ diff3 -m archivo.mio archivo.antiguo archivo.tuyo > archivo

Aquí se muestra una simplificación extrema de las órdenes propias de cada CVS para proporcionar una visión de conjunto. La secuencia de órdenes normal puede necesitar de opciones o parámetros.

Puede que quiera guardar parte de la configuración global en «~/.gitconfig» como su nombre y la dirección de correo electrónico que utiliza Git como se muestra.

$ git config --global user.name «Nombre Apellido«
$ git config --global user.email su_nombre@ejemplo.com

Si esta acostumbrado a utilizar órdenes Subversion o CVS, puede que quiera crear algunos alias de orden como se muestra.

$ git config --global alias.ci «commit -a«
$ git config --global alias.co checkout

Puede comprobar la configuración global como se muestra.

$ git config --global --list

Consulte lo siguiente.

Incluso cuando el servidor es otro CVS, puede ser una buena idea utilizar git(1) para la operaciones locales ya que permite gestionar la copia local del árbol del código fuente sin una conexión de red al servidor. Aquí estan algunos paquetes y órdenes utilizados con git(1).

Puedes comprobar un repositorio Subversion en «svn+ssh://svn.example.org/project/module/trunk» a un repositorio local Git en «./dest» y comprometer los cambios de vuelta al repositorio Subversion p. ej.:

$ git svn clone -s -rHEAD svn+ssh://svn.example.org/project dest
$ cd dest
... hacer los cambios
$ git commit -a
... sigua cambiando localmente con git
$ git svn dcommit

	Sugerencia
	La utilización de «-rHEAD» activa el evitar clonar el histórico del contenido entero del repositorio de Subversion.

La siguiente configuración permite comprometer a un repositorio CVS solo por un miembro del grupo «src» y la administración del CVS unicamente por un miembro del grupo «staff», que reduce la probabilidad de errores.

# cd /var/lib; umask 002; mkdir cvs
# export CVSROOT=/srv/cvs/project
# cd $CVSROOT
# chown root:src .
# chmod 2775 .
# cvs -d $CVSROOT init
# cd CVSROOT
# chown -R root:staff .
# chmod 2775 .
# touch val-tags
# chmod 664 history val-tags
# chown root:src history val-tags

	Sugerencia
	Puede restringuir la creación de un nuevo proyecto cambiando el dueño del directorio «$CVSROOT» «root:staff» y su permisos a «3775».

El repositorio por defecto de CVS esta referenciado por «$CVSROOT». Lo siguiente configura «$CVSROOT» para acceso local.

$ export CVSROOT=/srv/cvs/project

Cree una nueva ubicación de un árbol local en «~/path/to/module1» como se muestra.

$ mkdir -p ~/path/to/module1; cd ~/path/to/module1

Rellene un nuevo árbol local en «~/path/to/module1» con archivos.

Impórtelo a CVS con los siguientes parámetros.

$ cd ~/path/to/module1
$ cvs import -m «Start module1« module1 Rama-principal Release-initial
$ rm -Rf . # opcional

CVS no sobreescribe el archivo del repositorio actual si no que lo cambia por otro. Así, los permisos de escritura del directorio del repositorio son críticos. Para cada nuevo módulo de «module1» en el repositorio en «/srv/cvs/project», si es necesario, ejecute lo siguiente para asegurar que se cumple esto.

# cd /srv/cvs/project
# chown -R root:src module1
# chmod -R ug+rwX   module1
# chmod    2775     module1

Aquí esta un ejemplo paradigmático de flujo de trabajo con CVS.

Compruebe que todos los módulos disponibles del proyecto en el CVS son referenciados por «$CVSROOT» como se muestra.

$ cvs rls
CVSROOT
module1
module2
...

Compruebe «module1» en su directorio por defecto «./module1» como se muestra.

$ cd ~/path/to
$ cvs co module1
$ cd module1

Haga los cambios que se necesiten en el contenido.

Compruebe los cambios haciendo el equivalente a «diff -u [repositorio] [local]» como se muestra.

$ cvs diff -u

Encontrará que ha comedito errores en algunos archivos «archivo_a_deshacer» y que otros archivos son correctos.

Sobreescrita el archivo «archivo_a_deshacer» con una copia la copia en buen estado del repositorios CVS como se muestra.

$ cvs up -C archivo_a_deshacer

Guarde el árbol local actualizado en CVS como se muestra.

$ cvs ci -m «Descripción del cambio«

Cree y añada el archivo «archivo_para_añadir» al CVS como se muestra.

$ vi archivo_a_añadir
$ cvs add archivo_a_añadir
$ cvs ci -m «Añadido archivo_a_añadir«

Mezcle la última versión del CVS como se muestra.

$ cvs up -d

Vigile las líneas que empiezan por «C filename» ya que indican cambios conflictivos.

Mire el código que no se ha modificado en «.#nombre_del_archivo.version».

Los cambios conflictivos en los archivos los puede encontrar buscando por la cadena «<<<<<<<» y «>>>>>>>».

Modifique los archivos para resolver los conflictos según necesite.

Añada una etiqueta de distribución «Liberación-1» como se muestra.

$ cvs ci -m «último compromiso de la Liberación-1«
$ cvs tag Liberación-1

Editelo para continuar.

Borre la etiqueta de publicación «Liberación-1» como se muestra.

$ cvs tag -d Liberación-1

Compruebe los cambios del CVS como se muestra.

$ cvs ci -m «Últimos cambios comprometidos para la Liberación-1«

Vuelva a añadir al etiqueta de la publicación «Liberación-1» para actualizalar la cabecera CVS (CVS HEAD) del raíz como se muestra.

$ cvs tag Liberación-1

Crea una rama poniendo una marca persistente ('sticky') de rama «Correción-Liberación-inicial» a partir de la versión original apuntada por la etiqueta «Liberación-inicial» haga una comprobación de ella en el antiguo directorio «~/camino/al/antiguo» de la siguiente manera.

$ cvs rtag -b -r Liberación-inicial Correción-Liberación-inicial module1
$ cd ~/ruta/a
$ cvs co -r Correción-Liberación-inicial -d antiguo module1
$ cd antiguo

	Sugerencia
	Utilice «-D 2005-12-20» (formato de fecha ISO 8601) para especificar una fecha particular como un hito en la rama en lugar de «-r Lineración-inicial».

Trabaje en esta parte del árbol local teniendo como como etiqueta por defecto «Corrección-Liberación-inicial» la cual está basada en su versión original.

Trabaje en esta rama ... hasta que alguien más se una a la rama «CorrecciónLiberación-inicial».

Sincronize los archivos modificados con otros en el rama y cree los archivos que necesite como se muestra.

$ cvs up -d

Modifique los archivos para resolver los conflictos según necesite.

Compruebe los cambios del CVS como se muestra.

$ cvs ci -m «comprobado en esta rama«

Actualice el árbol local con el HEAD del principal mientras borra la etiqueta por defecto («-A») y sin la expansion del teclado («-kk») como se muestra.

$ cvs up -d -kk -A

Actualice el árbol local (contenido = raíz del principal) por la mezcla de la rama «Corrección-Liberación-inicial» y sin la expansión de teclado como se muestra.

$ cvs up -d -kk -j Corrección-Liberación-inicial

Corrija los conflictos con el editor.

Compruebe los cambios del CVS como se muestra.

$ cvs ci -m «Corrección-Liberación-inicial mezclada«

Realice el archivado como se muestra.

$ cd ..
$ mv antiguo corrección-antiguo-module1
$ tar -cvzf corrección-antiguo-module1.tar.gz corrección-antiguo-module1
$ rm -rf corrección-antiguo-module1

	Sugerencia
	La orden «cvs up» puede tener la opción «-d» para crear nuevos directorios y la opción «-P» para eliminar los directorios vacíos.

	Sugerencia
	Puede comprobar únicamente el subdirectorio «module1» dando su nombre como «cvs co module1/subdirectorio».

Para obtener los últimos archivos del CVS, utilice «tomorrow» como se muestra.

$ cvs ex -D tomorrow nombre_del_módulo

Añadir un alias «mx» a un módulo de un proyecto CVS (servidor local) como se muestra.

$ export CVSROOT=/srv/cvs/proyecto
$ cvs co CVSROOT/módulos
$ cd CVSROOT
$ echo «mx -a module1« >>módulos
$ cvs ci -m «Ahora mx es un alias para module1«
$ cvs release -d .

Ahora ya puede comprobar «module1» (alias: «mx») del CVS al directorio «nuevo» como se muestra.

$ cvs co -d nuevo mx
$ cd nuevo

	Nota
	Con el fin de llevar a cabo el procedimiento anterior, usted debe tener los permisos necesarios.

Cuendo compruebe los archivos del CVS su bit de ejecución será mantenido.

Si encuentra problemas de permisos de ejecución al comprobar un archivo, p. ej. «archivo», para arreglarlo cambie su permiso en el repositorio CVS correspondiente como se muestra.

# chmod ugo-x archivo

Actualmente el paquete subversion no crea ningún repositorio, así es que debe ser creado de forma manual. Una posible localización del repositorio es en /srv/svn/proyecto».

Cree un directorio como se muestra.

# mkdir -p        /srv/svn/proyecto

Cree la base de datos del repositorio como se muestra.

# svnadmin create /srv/svn/proyecto

Si solo accede al repositorio de Subversion a través del servidor Apache2, solo necesita hacer que el repositorio sea modificable solo por el servidor WWW como se muestra.

# chown -R www-data:www-data /srv/svn/proyecto

Añada (o descomente) lo siguiente en «/etc/apache2/mods-available/dav_svn.conf» para permitir el acesso al repositorio por medio de la autenticación de usuario.

<Location /project>
  DAV svn
  SVNPath /srv/svn/proyecto
  AuthType Basic
  AuthName «Subversion repository«
  AuthUserFile /etc/subversion/passwd
<LimitExcept GET PROPFIND OPTIONS REPORT>
    Require valid-user
</LimitExcept>
</Location>

Cree un archivo de autenticación de usuarios con la orden que se muestra.

# htpasswd2 -c /etc/subversion/passwd algún_nombre_de_usuario

Reinicie de Apache2.

Se puede acceder a su nuevo repositorio de Subversion en la URL «http://localhost/proyecto» y «http://example.com/proyecto» desde svn(1) (asumiendo que la URL de su servidor web es «http://example.com/»).

Lo siguiente configura el acceso local a un repositorio Subversion en función del grupo, p. ej. projecto.

# chmod  2775     /srv/svn/proyecto
# chown -R root:src /srv/svn/proyecto
# chmod -R ug+rwX   /srv/svn/proyecto

Su nuevo repositorio Subversion es accesible para los miembros del grupo local project a través de la URL «file:///localhost/srv/svn/proyecto» o «file:///srv/svn/proyecto» desde svn(1). Para asegurar el acceso del grupo debe ejecutar las órdenes svn, svnserve, svnlook y svnadmin con la máscara «umask 002».

El acceso remoto SSH a un repositorio Subversion basado en grupos se realiza mediante la URL «example.com:/srv/svn/proyecto», también puede acceder con svn(1) mediante la URL «svn+ssh://example.com:/srv/svn/proyecto».

Muchos proyectos utilizan un árbol de directorios similar para compensar la falta de ramas y etiquetas de Subversion.

  ----- module1
    |   |-- branches
    |   |-- tags
    |   |   |-- release-1.0
    |   |   `-- release-2.0
    |   |
    |   `-- trunk
    |       |-- file1
    |       |-- file2
    |       `-- file3
    |
    `-- module2

	Sugerencia
	Debe utilizar la orden «svn copy ...» para marcar ramas y etiquetas. Esto asegura que Subversion registra el histórico de modificaciones de archivos de forma adecuada y ahorra espacio de almacenamiento.

Cree una nueva ubicación de un árbol local en «~/path/to/module1» como se muestra.

$ mkdir -p ~/path/to/module1; cd ~/path/to/module1

Rellene un nuevo árbol local en «~/path/to/module1» con archivos.

Impórtela a Subversion con los parámetros siguientes.

$ cd ~/ruta/al/module1
$ svn import file:///srv/svn/proyecto/module1/trunk -m «Inicio del module1«
$ svn cp file:///srv/svn/proyecto/module1/trunk file:///srv/svn/proyecto/module1/tags/Liberación-inicial

Otra forma es como se muestra.

$ svn import ~/ruta/al/module1 file:///srv/svn/proyecto/module1/trunk -m «Inicio del module1«
$ svn cp file:///srv/svn/proyecto/module1/trunk file:///srv/svn/proyecto/module1/tags/Liberación-inicial

	Sugerencia
	Puede sustituir las URLs del tipo «file:///…» por otros formatos de URLs como «http://…» y «svn+ssh://…».

Aquí esta un ejemplo de flujo de trabajo estándar utilizando Subversion con su cliente nativo.

	Sugerencia
	La orden cliente que aporta el paquete git-svn puede ofrecer un flujo de trabajo alternativo de Subversion utilizando la orden git. Consulte Sección 10.6.4, “Git para repositorios Subversion”.

Enumere todos los módulos disponibles del proyecto Subversión que se referencias por la URL «file:///srv/svn/proyecto» como se muestra.

$ svn list file:///srv/svn/proyecto
module1
module2
...

Compruebe «module1/trunk» al directorio «module1» como se muestra.

$ cd ~/ruta/al
$ svn co file:///srv/svn/proyecto/module1/trunk module1
$ cd module1

Haga los cambios que se necesiten en el contenido.

Compruebe los cambios haciendo el equivalente a «diff -u [repositorio] [local]» como se muestra.

$ svn diff

Encontrará que ha comedito errores en algunos archivos «archivo_a_deshacer» y que otros archivos son correctos.

Sobreescriba «archivo_a_deshacer» con una copia limpia de Subversion como se muestra.

$ svn revert archivo_a_deshacer

Guarde un árbol local actualizado en Subversión como se muestra.

$ svn ci -m «Descripción del cambio«

Cree y añada un archivo «archivo_a_añadir» como se muestra.

$ vi archivo_a_añadir
$ svn add archivo_a_añadir
$ svn ci -m «Añadido archivo archivo_a_añadir«

Mezcle la última versión de Subversion como se muestra.

$ svn up

Vigile las líneas que empiezan por «C filename» ya que indican cambios conflictivos.

MIre el código no modificado en p. ej. «nombre_de_archivo.r6», «nombre_de_archivo.r9» y «nombre_de_archivo.mio».

Los cambios conflictivos en los archivos los puede encontrar buscando por la cadena «<<<<<<<» y «>>>>>>>».

Modifique los archivos para resolver los conflictos según necesite.

Añada una etiqueta de distribución «Liberación-1» como se muestra.

$ svn ci -m «Última entrega para la Liberación-1«
$ svn cp file:///srv/svn/proyecto/module1/trunk file:///srv/svn/proyecto/module1/tags/Liberación-1

Editelo para continuar.

Borre la etiqueta de publicación «Liberación-1» como se muestra.

$ svn rm file:///srv/svn/proyecto/module1/tags/Liberación-1

Comprometa los cambios en Subversion como se muestra.

$ svn ci -m «Realmente la última entrega para la Liberación-1«

Vuelva a añadir al etiqueta de liberación «Liberación-1» de la cabeza de «trunk« de la versión actualizada de Subversion como se muestra.

$ svn cp file:///srv/svn/proyecto/module1/trunk file:///srv/svn/proyecto/module1/tags/Liberación-1

Creee una rama con la ruta «module1/ramas/Corrección-Liberación-inicial» de la versión original referenciada por la ruta «module1/etiquetas/Liberación-inicial» y compruebela en el directorio «~/ruta/al/antiguo» como se muestra.

$ svn cp file:///srv/svn/proyecto/module1/etiquetas/LIberación-inicial file:///srv/svn/proyecto/module1/ramas/Corrección-Liberación-inicial
$ cd ~/ruta/a
$ svn co file:///srv/svn/proyecto/module1/ramas/corrección-Liberación-inicial antiguo
$ cd antiguo

	Sugerencia
	Utilice «module1/trunk@{2005-12-20}» (formato de fecha ISO 8601) en vez de «module1/tags/Liberación-inicial» para especificar una fecha determinada como punto de bifurcación.

Trabaje en este árbol local que refencia a la rama «Corrección-Liberación-inicial» la cual esta basada en la versión original.

Trabaje en esta rama ... hasta que alguien más se una a la rama «CorrecciónLiberación-inicial».

Sincronice los archivos modificados por tercereos en esta rama como se muestra.

$ svn up

Modifique los archivos para resolver los conflictos según necesite.

Comprometa los cambios en Subversion como se muestra.

$ svn ci -m «Comprobando esta rama«

Actualice el árbol local con el comienzo de trunk como se muestra.

$ svn switch file:///srv/svn/proyecto/module1/trunk

Actualice el árbol local (contenido = raíz de «trunk«) mezclandolo con la rama «Corrección-Liberación-inicial» como se muestra.

$ svn merge file:///srv/svn/proyecto/module1/ramas/Corrección-Liberación-inicial

Corrija los conflictos con el editor.

Comprometa los cambios en Subversion como se muestra.

$ svn ci -m «Corrección-Liberación-inicial mezclada«

Realice el archivado como se muestra.

$ cd ..
$ mv antiguo corrección-antiguo-module1
$ tar -cvzf corrección-antiguo-module1.tar.gz corrección-antiguo-module1
$ rm -rf corrección-antiguo-module1

	Sugerencia
	Puede sustituir las URLs del tipo «file:///…» por otros formatos de URLs como «http://…» y «svn+ssh://…».

	Sugerencia
	Puede comprobar unicamente un subdirectorio de «module1» proporcionando su nombre como en «svn co file:///srv/svn/proyecto/module1/trunk/subdir module1/subdir», etc.