{"id":656,"date":"2008-05-09T18:12:26","date_gmt":"2008-05-09T17:12:26","guid":{"rendered":"http:\/\/www.marblestation.com\/blog\/?p=656"},"modified":"2012-04-26T16:27:24","modified_gmt":"2012-04-26T14:27:24","slug":"trac-gestion-documental-e-incidenciasmejoras-con-repositorio-git","status":"publish","type":"post","link":"https:\/\/www.marblestation.com\/?p=656","title":{"rendered":"Trac, gesti\u00f3n documental e incidencias\/mejoras con repositorio Git"},"content":{"rendered":"

Trac<\/a> es un sistema de gesti\u00f3n documental (wiki), incidencias\/mejoras (issue tracking system) para proyecto de desarrollo de Software.<\/p>\n

Actualmente, en su especialidad es uno de los sistemas m\u00e1s utilizados. La versi\u00f3n original se encuentra dise\u00f1ada para ser integrada con repositorios de control de versiones Subversion, pero existen diversos plugins que nos permiten utilizar otros backends… como por ejemplo Git<\/a>.<\/p>\n

Veamos como podemos instalar y poner en marcha el sistema Trac con un repositorio Git…
\n<\/p>\n

Instalaci\u00f3n en Ubuntu GNU\/Linux<\/h3>\n

La versi\u00f3n de Trac disponible en los repositorios de Ubuntu es la 0.10 actualmente y personalmente, prefiero instalar de forma manual Trac para as\u00ed utilizar la \u00faltima versi\u00f3n. Para ello, primero tendremos que instalar varias dependencias:<\/p>\n

\r\n$ sudo aptitude install python-setuptools\r\n$ sudo aptitude install python-pysqlite2\r\n<\/pre>\n
Acto seguido, bajamos la versi\u00f3n que nos interese de Trac<\/a>, descomprimimos e instalamos:<\/p>\n
\r\n$ cd Trac-0.11rc1\/\r\n$ sudo python setup.py install\r\n<\/pre>\n
A continuaci\u00f3n, descargamos Git Plugin<\/a> y descomprimimos. En mi caso particular me he encontrado con un peque\u00f1o bug en el plugin que me imped\u00eda visualizar versiones antiguas del repositorio Git desde Trac, para arreglarlo simplemente tuve que modificar el fichero ‘gitplugin\/0.11\/tracext\/git\/git_fs.py’, l\u00ednea 252:<\/p>\n
\r\ndef previous_rev(self, rev, path='');\r\n<\/pre>\n
La modificaci\u00f3n consiste en a\u00f1adir el tercer argumento ‘path’. El bug lo he reportado<\/a> e imagino que el autor lo validar\u00e1 y corregir\u00e1 (si aplica) en algun momento. <\/p>\n
Es posible que cuando le\u00e1is este art\u00edculo, ya se encuentre corregido y por tanto podemos olvidarnos y pasar directamente a instalar el plugin:<\/p>\n
\r\n$ cd gitplugin\/0.11\r\n$ sudo python setup.py install\r\n<\/pre>\n
Instalaci\u00f3n en Microsoft Windows XP<\/h3>\n
En Windows me gusta trabajar directamente desde la terminal Cygwin<\/a> y por tanto, doy por supuesto que tenemos instalada esa herramienta con los paquetes que listo en este art\u00edculo sobre Cygwin<\/a> m\u00e1s el paquete para soportar Python.<\/p>\n
Para instalar Trac, previamente necesitaremos instalar varias dependencias: setuptools<\/a> y Genshi<\/a>. Descargaremos los “.egg” y los instalaremos mediante los siguientes comandos:<\/p>\n
\r\nsh setuptools-0.6c8-py2.5.egg \r\neasy_install Genshi-0.4.4-py2.5.egg \r\n<\/pre>\n
Por otra parte, tambi\u00e9n necesitaremos descargar PySQLite<\/a>, descomprimir e instalar:<\/p>\n
\r\ncd pysqlite-2.4.1\/\r\npython setup.py install\r\n<\/pre>\n
Finalmente, bajamos la versi\u00f3n que nos interese de Trac<\/a>, descomprimimos e instalamos:<\/p>\n
\r\ncd Trac-0.11rc1\/\r\npython setup.py install\r\n<\/pre>\n
Configuraci\u00f3n b\u00e1sica<\/h3>\n
Trac funciona de forma que necesitamos generar una instancia para cada proyecto, imaginemos que ya tenemos un repositorio Git<\/a> en el directorio ‘\/home\/usuario\/repo\/’ y queremos generar la interfaz web Trac.<\/p>\n
En primer lugar generaremos una instancia de Trac en el directorio que nos interese:<\/p>\n
\r\nmkdir test\r\ntrac-admin test\/ initenv\r\n<\/pre>\n
Trac-admin nos realizar\u00e1 diversas preguntas, en general podemos dejar todo por defecto excepto el sistema de control de versiones que ser\u00e1 ‘git’ y el path del repositorio, el cual debe apuntar al directorio ‘.git\/’, por ejemplo: ‘\/home\/usuario\/repo\/.git’.<\/p>\n
A continuaci\u00f3n, editamos el fichero ‘test\/conf\/trac.ini’ y validamos que el archivo incluye la siguiente informaci\u00f3n (en caso de que haya algo diferente o ausente, deberemos modificarlo o a\u00f1adirlo):<\/p>\n
\r\n[git]\r\ncached_repository = true\r\ngit_bin = \/usr\/bin\/git\r\npersistent_cache = true\r\nshortrev_len = 7\r\n\r\n[components]\r\n# for plugin version 0.11.0.1+\r\ntracext.git.* = enabled\r\n<\/pre>\n
A continuaci\u00f3n, crearemos un usuario con su respectivo password. Para ello necesitamos primer generar un script<\/a> que nos ayude, creamos el fichero ‘trac-digest.py’ con el siguiente contenido:<\/p>\n
\r\nfrom optparse import OptionParser\r\nimport md5\r\n\r\n# build the options\r\nusage = \"usage: %prog [options]\"\r\nparser = OptionParser(usage=usage)\r\nparser.add_option(\"-u\", \"--username\",action=\"store\", dest=\"username\", type = \"string\",\r\n                  help=\"the username for whom to generate a password\")\r\nparser.add_option(\"-p\", \"--password\",action=\"store\", dest=\"password\", type = \"string\",\r\n                  help=\"the password to use\")\r\n(options, args) = parser.parse_args()\r\n\r\n# check options\r\nif (options.username is None) or (options.password is None):\r\n   parser.error(\"You must supply both the username and password\")\r\n   \r\n# Generate the string to enter into the htdigest file\r\nrealm = 'trac'\r\nkd = lambda x: md5.md5(':'.join(x)).hexdigest()\r\nprint ':'.join((options.username, realm, kd([options.username, realm, options.password])))\r\n<\/pre>\n
A continuaci\u00f3n generamos el usuario y lo guardamos en el fichero ‘digest.txt’:<\/p>\n
\r\n$ python trac-digest.py -u usuario -p password > digest.txt\r\n<\/pre>\n
Al usuario generado, le daremos permisos de administraci\u00f3n total:<\/p>\n
\r\n$ trac-admin test\/ permission add usuario TRAC_ADMIN\r\n<\/pre>\n
Y finalmente, ejecutaremos el servidor web integrado Tracd<\/a> para que escuche por el puerto 8080, utilice nuestro fichero de usuarios y permita acceso a la instancia de Trac que acabamos de generar:<\/p>\n
\r\n$ tracd --port 8080 --auth=test,digest.txt,trac test\/\r\n<\/pre>\n
Para acceder a Trac simplemente tendremos que visitar la URL http:\/\/127.0.0.1:8080\/test\/<\/a>, identifiarnos y empezar a jugar con el \ud83d\ude09<\/p>\n
Para entornos estables lo ideal es configurar un servidor web Apache, para esto lo mejor es consultar directamente la documentaci\u00f3n de Trac<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Trac es un sistema de gesti\u00f3n documental (wiki), incidencias\/mejoras (issue tracking system) para proyecto de desarrollo de Software. Actualmente, en su especialidad es uno de los sistemas m\u00e1s utilizados. La versi\u00f3n original se encuentra dise\u00f1ada para ser integrada con repositorios de control de versiones Subversion, pero existen diversos plugins que nos permiten utilizar otros backends… … Continue reading Trac, gesti\u00f3n documental e incidencias\/mejoras con repositorio Git<\/span> →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1,6],"tags":[],"class_list":["post-656","post","type-post","status-publish","format-standard","hentry","category-espanyol","category-tecnologia"],"_links":{"self":[{"href":"https:\/\/www.marblestation.com\/index.php?rest_route=\/wp\/v2\/posts\/656","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.marblestation.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.marblestation.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.marblestation.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.marblestation.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=656"}],"version-history":[{"count":1,"href":"https:\/\/www.marblestation.com\/index.php?rest_route=\/wp\/v2\/posts\/656\/revisions"}],"predecessor-version":[{"id":1248,"href":"https:\/\/www.marblestation.com\/index.php?rest_route=\/wp\/v2\/posts\/656\/revisions\/1248"}],"wp:attachment":[{"href":"https:\/\/www.marblestation.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=656"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.marblestation.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=656"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.marblestation.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=656"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}