Crear un proyecto en Trac-SVN

(Windows)
Por: Jos Alberto Lpez Garca

Para este ejemplo: Se crear un proyecto llamado codeOnSvn. La ruta de instalacin del trac es: C:\Trac. La ruta del servidor svn es: C:\Repos El nombre del servidor es: trac-smart, pero bien podra ser una direccin ip, p.ej. 192.168.2.23 ********Para crear proyectos en el trac*********** 1. Abrir una consola o smbolo de sistema 2. Desde la carpeta de instalacin (P ej. C:/trac/) escribir lo siguiente: call scripts/setenv.bat

3. Agregar proyecto a Trac, al agregar la ruta del repositorio esta deber ser absoluta. En caso de que sea relativa, ser relativa al proyecto de trac no a la carpeta actual, usar el siguiente comando: trac\Scripts\trac-admin projects\ProjectName initenv Para nuestro ejemplo el comando sera el siguiente: trac\Scripts\trac-admin projects\codeOnSvn initenv a. Se nos pedira el nombre del proyecto, escribimos el mismo nombre que se le dio en el comando anterior: codeOnSvn. b. Despus la cadena de conexin a la base de datos, dejaremos esto como viene por default, as que no escribimos nada y presionamos enter. c. Nos informar que se est procesando la creacin de nuestro proyecto en el Trac.

d. Finalmente nos informara que el proceso se completo con xito 4. Ahora debemos crear el proyecto en el servidor SVN, para esto usamos el siguiente comando. Es muy importante usar rutas absolutas. ( Si el directorio C:/repos no existe, ser necesario crearlo) svnadmin create c:\repos\ProjectName Para nuestro ejemplo el comando seria el siguiente: svnadmin create c:\repos\codeOnSvn 5. En esta configuracin utilizaremos la autenticacin de usuarios de Apache para hacer login en el trac, y para agregar usuarios a apache usaremos el siguiente comando: apache2\bin\htpasswd trac\conf\htpasswd username Usaremos como ejemplos de nombre de usuario y password los siguientes: usuarioTrac/0987654321, y el comando quedara asi: apache2\bin\htpasswd trac\conf\htpasswd usuarioTrac Una vez introducido el comando nos pedir el password 2 veces. Este proceso se repite para cada usuario que se desee dar de alta.

6. Si se desean proporcionar privilegios de administracin a un usuario en particular, usaremos el siguiente comando: trac\Scripts\trac-admin projects\MiProyecto permission add nombreUsuario TRAC_ADMIN

Para nuestro ejemplo con el usuario que hemos creado, el comando quedara de la siguiente manera: trac\Scripts\trac-admin projects\codeOnSvn permission add usuarioTrac TRAC_ADMIN Una vez hecho esto, se agregara la pestaa Admin en el sitio web del trac, lo que permitir desempear labores de administracin.

NOTA: En algunos casos, se debe desbloquear el puerto 3690 para tener acceso a svn y la ruta seria svn://ip/Trac/repos/ProjectName 7. Ahora como ultimo paso vamos a configurar los permisos de acceso a los elementos alojados en el servidor SVN. a. Ubicamos el archivo que tiene la configuracin del proyecto en el servidor SVN, para nuestro ejemplo seria: C:\Repos\codeOnSvn\conf\svnserve.conf b. Ubicamos las siguientes lneas:
# anon-access = read # auth-access = write

.
# password-db = passwd

Y las descomentamos y cambiamos el parmetro del acceso no autorizado, quedara de la siguiente manera.
anon-access = none auth-access = write

.
password-db = passwd

Esta configuracin significa que los accesos no autorizados no estn permitidos de manera que nadie puede descargar o visualizar nuestros elementos subversionados, la ultima lnea le dice al nuestro servidor que los datos de autenticacin se encuentran en el archivo llamado passwd c. Ahora vamos a especificar los nombres de usuario y password de los usuarios que tendrn acceso al servidor SVN. Esto se hace en el archivo passwd ubicado en el mismo directorio del paso anterior, en nuestro ejemplo la ruta seria la siguiente: C:\Repos\codeOnSvn\conf\ passwd, lo podemos abrir con un bloc de notas o de preferencia con un WordPad. Los nombres de usuario se especifican en el formato de pares, a continuacin se muestra un usuario con nomnbre de usuario usuarioTrac y password usuarioTrac
[users] usuarioTrac = usuarioTrac # sally = sallyssecret

NOTA: La autorizacin de uso de recursos o autenticacin es diferente para el TRAC( interfaz web) y para el servidor SVN, lo recomendable seria usar el mismo nombre de usuario en ambas pero al password agregar al final o al principio algo que los distinga, p ej. un password del trac podra ser 3mpr3s4TRAC y un password del SVN podra ser 3mpr3s4SVN

************************** IMPORTANTE *************************************

En la versin 0.12 de Bitnami trac-svn por alguna razn el cdigo o elementos subversionados no se sincronizan con el servidor svn y el trac, pero es muy sencillo hacerlo. Configurar el servidor en el archivo .ini del proyecto (trac\projects\nombreProyecto\trac.ini), para nuestro ejemplo iremos a la siguiente direccin:
C:\Trac\projects\codeOnSvn\conf\trac.ini

Abrimos el archivo y ubicamos la seccin [Trac] y la opcin repository_dir, que esta vaca, ah especificaremos la ruta del cdigo, que en nuestro ejemplo seria:
C:/repos/codeOnSvn

[Trac]
permission_store = DefaultPermissionStore pg_dump_path = pg_dump

repository_dir = C:/repos/codeOnSvn
repository_sync_per_request = (default) repository_type = svn

************************************************

Para subir el cdigo al servidor

1. Instalar Tortoise SVN 2. Hacer una carpeta en un directorio x de Windows. 3. Clic derecho sobre la carpeta y seleccionar la opcin SVN Checkout

4. En la siguiente ventana, proporcionar la url del proyecto, es utilizado mas comnmente el protocolo svn, aunque tambin el protocolo http es soportado. La url puede ser conformada por la direccin ip del servidor, el nombre de la maquina que aloja el servicio si se esta en una red local, o el nombre del servidor registrado en un DNS en el caso de usar un protocolo http (p ej. http://smart.com/repos/MiProyecto). En nuestro ejemplo seria la siguiente: svn://trac-smart/repos/codeOnSVN

5. Al dar clic en OK nos pedir el nombre de usuario y contrasea del servidor SVN no del trac, en nuestro ejemplo fueron usuarioTrac/usuarioTrac, y hacer clic en OK. Nos informar la revisin que ha sido descargada, en nuestro caso es la cero porque no hemos subido ningn cambio.

6. En este momento el servidor no tiene ningn dato subversionado, lo que se est haciendo es inicializarlo de manera local para despus hacer un commit y dejar lo preparado. Lo siguiente es crear la estructura bsica de un servidor SVN. Crear tres carpetas con los nombre trunk, tags y branches respectivamente dentro de la carpeta del proyecto (p.ej. C:/miProyecto/trunk/, C:/miProyecto/tags/ y C:/miProyecto/branches/) 7. Seleccionar las 3 carpetas y dar clic con el botn derecho sobre ellas, ir al men TortoiseSVN/add.

8. En la siguiente ventan dar clic en OK, y uan ventana mas nos confirmar que el proceso se completo con xito.

9. Finalmente haremos el commit inicial con la estructura inicial del proyecto. Para esto hacemos clic con el botn derecho sobre la carpeta del proyecto y seleccionamos la opcin SVN Commit, en la siguiente ventana colocamos un comentario relativo al commit que estamos haciendo, en este caso podra ser Creando la estructura inicial del proyecto, hacemos clic en OK y el primer commit quedara terminado,

0-1Ventana del primer commit

10. Ahora podremos colocar el cdigo de nuestro proyecto en la carpeta trunk, una vez copiados los archivos y se repite el paso 9.

11. Finalmente es importante que las operaciones de chekout posteriores a este proceso se debern hacer de las carpetas indicadas, por ejemplo si alguien se va a integrar al desarrollo del proyecto la ruta para hacer el checkout seria de la carpeta trunk, por lo tanto su descarga seria de la url: svn://trac-smart/repos/codeOnSVN/trunk en lugar de svn://trac-smart/repos/codeOnSVN

Comandos tiles
resync para hacer el resync: En una consola o smbolo de sistema: 1.- trac\Scripts\trac-admin projects\ProjectName 2.- repository resync repositoryName Imagen de logo del proyecto en el trac For the logo, set the src to site/fileNameLogo.png, and put "myImageLogo.png" into the <path-to-trac-environment>/htdocs directory. El archivo de imagen se pone en la carpeta_del_Proyecto/htdocs/miImagen.png En el archivo de configuracion .ini del proyecto especificar la url de la imagen, el texto alternativo, el ancho y alto, estos dos ultimos deben ser lo mas exactos a los valores reales de la imagen. [header_logo] alt = (please configure the [header_logo] section in trac.ini ) height = 52 link = src = site/images/DLLIcon.png width = 253

+++++++++++++++++++++++++++++ propiedad svn:externals +++++++++++++++++++++++++++ Existe la posibilidad de tener dentro de un proyecto subversionado codigo externo, de manera que se codigo sea reutilizado en varios proyectos, ademas que ese codigo externo pueda ser modificado y actualizado en todos los proyectos donde se este utilizando; para esto se utiliza la propiedad svn:externals Procedimiento: 1.- Ubicar la carpeta donde se desea alojar el codigo externo.(p. ej. c:/DllCom/lib/) 2.- Clic derecho sobre la carpeta->TortoiseSVN->properties 3.- Si no existe la propiedad externals, hacer clic en el boton new, si no seleccionar la propiedad y dar clic en editar. 4.- Colocar el valor de la propiedad con al siguiente sintaxis: FolderName svn://server/proyect/ Indicar el nombre del directorio que alojara el codigo externo seguido de un espacio la url del proyecto externo. **** si se desea agregar mas de un directorio externo separarlos por un salto de linea siguien la misma sintaxis de la primer linea. 5.- MUY IMPORTANTE: despues de agregar los elementos externos, es indispensable hacer un

commit para que los cambios queden registrados, asi todos los updates siguientes obtendran las propiedades recien agregadas. 6.- Finalmente hacer un UDPATE para revisar que se descargaron correctamente los elementos recien agregados. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Estas notas han sido elaboradas en base a la experiencia personal, sin embargo, es posible encontrar mucha informacin mas en la red, especficamente en el sitio del trac: http://trac.edgewall.org/