Rooteando Blog 1/19

Redmine, gestor de proyectos

28 de Octubre de 2016 a las 01:36

Redmine es un gestor de proyecto escrito en Ruby on Rails que nos permitirá

administrar los usuarios del proyecto, los errores con un sistema de tickets, wiki,
calendario...etc. Tiene integración con diversos sistemas de control de versiones como
SVN, CVS, Git, Mercurial, Bazaar y Darcs.

Pero la pregunta es; ¿qué ventajas tiene utilizar un gestor de proyecto?, para mi tiene
varias pero la mas importante es la organización. Nos permite administar un proyecto
de forma mas eficiente,entre las tareas que se puede realizar en Redmine, podemos
crear una lista de funcionalidades que tienes que implementar en un proyecto, permite
llevar un control preciso de los errores que surgen asignándole una prioridad y
diferentes recursos. dispone de un calendario, nos permite crear diagramas de Gantt,
se puede crear un wiki para los proyectos, integrar un repositorio,dispone de un sistema
para publicar noticias, podemos administrar los diferentes documentos de un proyecto,
es multiusuario,soporte de perfiles de usuarios...etc. Por último, Redmine permite la
gestión de varios proyectos.

Redmine esta disponible para Linux,Windows y Mac.

Instalación

Para instalar Redmine se necesita un servidor Web, una base de datos que puede ser
Mysql o Postgresql, también se requiere Ruby, Rails , rake y otros módulos.

Hay tres formas de ejecutar Redmine; ejecutando el servidor Web Webrick que se
incluye con Rails , otras forma es ejecutándolo en un servidor web Apache, para esta
f or ma Redmine se debe configurar como un VirtualHost. Por último mediante los
instaladores de Bitnami y Turnkey , la primera de estas dos opciones es la que he
probado y consiste en una aplicación que facilitan la instalación de Redmine, haya de
varios tipos: instalador solo con Redmine, instalador con Redmine y todos los
requerimientos (Apache,Ruby, Mysql...etc) o una imagen virtual para WMvare o
VirtualBox , esta imagen consiste en una instalación mínima de Ubuntu con Redmine y
todos sus requerimientos. Los instaladores de Bitnami están disponibles para Linux ,
Windows y Mac.

Para un entorno de pruebas recomiendo utilizar el servidor Webrick,incluido en Rails ,

aunque requiere una pequeña configuración, mirar aquí, sino no tienes mucho tiempo
para configuraciones, la mejor opción es utilizar Bitnami tanto la imagen virtual que te lo
da todo hecho como los instaladores . Para un entorno en producción es recomendable
utilizar Redmine con Apache, para esto tendrás que crear un Virtualhosts , para
configurarlo mirar aquí o aquí.

Resumiendo, salvo si utilizas la imagen que proporciona Bitnami, la instalación se realiza

en muy pocos pasos, las otras formas de instalación requiere seguir una serie de pasos

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 2/19
que no son muy difíciles aunque pueden dar algún problema. En mi caso, lo que mas me
costo fue configurar el VirtualHosts en Apache como yo quería, pero hay mucha
documentación en Internet sobre la instalación de Redmine y la documentación oficial
ayuda bastante.

Configuración de Redmine

Dependiendo de que instalación hayas realizado deberás poner una dirección web un
poco diferente en el navegador. En mi caso lo instalado como un VirtualHost, en mi
configuración, abro el navegador y pongo la siguiente dirección

http://192.168.1.100/redmine

Para empezar ha trabajar solo tendremos que en el enlace de conexión y se mostrara la

pantalla de login, por defecto Redmine solo tiene habilitado en usuario administrador,
nombre admin y contraseña admin. Con esto ya podemos empezar a gestionar nuestro
proyectos .

Caso de ejemplo

Tenemos una empresa desarrolladora que desea probar Redmine en un proyecto que ha
empezado hace poco, proyecto rooteando. Este proyecto tiene dos desarrolladores:
Alfonso y David, tienen un repositorio Git donde tienen el código del proyecto. En
Redmine realizaremos las siguientes tareas:

David sera el jefe de proyecto y le asignaremos ese rol en Redmine, utilizara la

Blog de J.A. Jimenez Toro, rooteando.com
Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 3/19
cuenta de admin para trabajar.
Crear el usuario Alfonso y le asignaremos el rol de desarrollador.
Crear el proyecto rooteando y asignarle los usuarios.
Crear nuevas versiones del proyecto.
Gestionar diferentes tipos de peticiones.
Integrar el repositorio de Git en Redmine y hacer varias pruebas.

Redmine esta instalado y funcionando, David se encuentra en la pantalla inicial de

Redmine, ver imagen anterior, pulsamos en Conexión. Como es la primera vez que nos
conectamos ,el identificador es admin y la contraseña es admin. De esta forma
tendremos acceso al usuario administrador que tiene todos los permisos asignados, lo
primero es cambiarle la contraseña por defecto. En la parte superior de la página
tenemos varios opciones, una de ella es Administración.

Donde podemos administrar las diferentes aspectos de Redmine. Pulsamos en la opción

de Usuarios , donde se mostrara una lista de los usuarios,ahora solo tenemos el usuario
admin, este usuario será el que utilice David aunque podría crear un usuario con
privilegios de administrador. Pulsamos en el usuario admin para que muestre toda la
información.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 4/19

Prácticamente todos los cuadros están etiquetados de forma muy clara con lo que no
tienen mucha explicación, es posible que tengas que cambiar el idioma a español.
Escribimos una nueva contraseña en el apartado Autentificación y pulsamos en el botón
de Guardar, ya esta cambiada la contraseña.

Lo siguiente es crear un proyecto nuevo, sin salir de la página anterior en la parte

derecha pulsamos en Proyectos . En la página de Proyectos aparece una lista de los
proyectos que gestiona Redmine, en esta caso no muestra nada porque no hay
proyectos, para crear un proyecto pulsar en el Nuevo proyecto.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 5/19

Se especifica el nombre del proyecto, en este ejemplo es rooteando, una descripción

opcional y un identificador. Si dejamos la opción de Público marcada el proyecto será
visible para todo el mundo, si la desmarcamos será obligatorio hacer login para ver el
proyecto. En el apartado de Módulos , se eligen los módulos que estarán disponibles
para el proyecto y en Peticiones decidimos que tipo de peticiones estarán disponibles,
David deja marcadas todas las opciones. Pulsamos en Guardar y ya esta creado el
proyecto.

Desde este momento en el apartado Proyecto de la opción aparecerá en la lista de

proyectos rooteando, ahora habrá que asignarle usuarios al proyecto, en principio será
el usuario David, que será el usuario admin, y después crearemos el usuario Alfonso,
cada usuario tendrá asignado un perfil. En Redmine hay varias perfiles definidos y cada
perfil con una serie permisos asignados.

Dentro de la sección de Administración pulsamos en Proyectos , ahora se vera el

proyecto creado anteriormente, pulsamos en el proyecto rooteando. Se mostrara el
apartado de Configuración para el proyecto , en la parte superior veremos una serie de
pestañas con diferentes opciones que podemos configurar. Pulsamos en la pestaña
Miembros .

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 6/19

En esta pestaña se asignan al proyecto los usuarios y el perfil que tendrá asignado para
este proyecto, en el lateral se ven los usuarios y perfiles disponibles. Solo aparece el
usuario admin, que será utilizado por David, y tres perfiles, en este caso marcamos el
usuario admin , el perfil Jefe de proyecto y pulsamos en Añadir. David será el jefe de
proyecto del proyecto rooteando con lo que tendrá todos los permisos.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 7/19

Si se quiere ver todos los perfiles disponibles y los permisos de cada perfil. Pulsamos en
la opción Administración->Perfiles y permisos . Se mostraran todos los perfiles
disponibles, incluso podremos crear nuevos perfiles pulsando en Nuevo perfil, si
pulsamos en informes de permisos .

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 8/19

Tenemos la lista de permisos activados para cada perfil, se puede personalizar cada
perfil marcando y desmarcando en los permisos.

David crea el usuario Alfonso que le asignara el perfil de Desarrollador, dentro de

Administración pulsamos en Usuarios , Nuevo usuario, se rellenan los datos para Alfonso
y para finalizar se pulsa en Crear.

Ahora se vera una pestaña nueva, Proyectos , que servirá para asignar proyectos al
usuario creado, seleccionamos en Nuevo proyecto a rooteando y en perfil escogemos
Desarrollador y añadimos el usuario.

Ahora tenemos dos usuario, David y Alfonso, que tiene asignado el proyecto rooteando
y diferentes perfiles, jefe de proyecto y desarrollador.

Integración con Git

David y Alfonso ya han comenzado el proyecto de rooteando y tienen un repositorio Git

con el código del proyecto. Lo que quieren es integrar Redmine con el repositorio Git, de
esta forma Redmine tendra acceso al código. Redmine permite integrar repositorios de
diferentes sistemas de control de versiones como Subversion,Git,Baazar,Mercurial...etc.

Para integrar el repositorio , accedemos como admin, pulsamos en el apartado

Administración,Proyectos y escogemos el proyecto rooteando. Accederemos a la página
de Configuración de rooteando, pulsamos en la pestaña de Repositorios y escogemos el
tipo( Git en este caso) se mostraran nuevas opciones.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 9/19

En el apartado Ruta al repositorio se especifica la ruta hasta el repositorio que queremos

integrar, por ejemplo "/home/pepe/Proyecto/rooteando/", la codificación la dejamos por
defecto y marcamos la última opción para que nos informes de los commit, pulsamos en
Crear. Es posible que algunas veces no se vean los commit que se han realizado
recientemente, para esto recarga la página de Repositorio para que se muestren.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 10/19

Ahora se verán todos los archivos que hay en el repositorio, en la parte de abajo se
muestra los commit realizados(revisiones). Si pulsamos en un commit podremos verlo
con mas detalle e incluso ver las diferencias entre versiones. En la parte de arriba
tenemos la opción de Estadisticas donde veremos dos gráficos, unos para los commits
y el otro muestra los commit por usuario, otra opción es Ramas que muestra las
diferentes ramas que tenga el repositorio Git.

El repositorio tiene dos ramas, master donde se almacena la versión estable del
proyecto y la rama desarrollo donde David y Alfonso trabajan habitualmente, cuando una
versión de esta rama se considera estable se fusiona con la rama master. Si nos vamos
a la opción de Ramas de Redmine y escogemos la rama de desarrollo.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 11/19

En esta rama tenemos mas commit que en la rama master, las ramas son
independientes cada una tiene sus propios commit, aunque cuando se crea una rama al
principio es una copia de la rama master, todas las demás opciones explicadas para la
rama master son aplicables en esta rama.

Peticiones

Hay tres tipos de peticiones;Errores , Tareas y Soporte, estas peticiones se pueden

asignar a diferentes usuarios, se le puede especificar un tiempo o asignar una versión
especifica del proyecto. Empecemos con esto último, David (el jefe de proyecto) ha
considerado que proyecto ha alcanzado la versión 0.1, con lo que crea una nueva
versión en Redmine. Nos vamos al apartado de Configuración y escogemos la pestaña
Versión, aparece un enlace de Nueva versión, pulsamos en el enlace.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 12/19

Primero definimos el nombre de versión ,en este caso David escoge Versión 0.1 una
descripción "Primera versión estable del proyecto rooteando", escogemos el estado de la
versión, como es la versión con que vamos a trabajar dejamos el estado abierto. como
no tiene una página de wiki lo dejamos en blanco, escogemos la fecha actual (pulsar en
botón que se encuentra a la derecha para especificar la fecha) y la última opción
Compartir la dejamos por defecto. Pulsamos en Crear ya tenemos creada la primera
versión de rooteando.

David crea dos peticiones en la versión 0.1, la primera será un error que hay que
corregir urgentemente y la segunda es una petición de tipo tarea para añadir una nueva
característica al proyecto .

Nos vamos al apartado de Nueva petición,escogemos el tipo Error y el Tema " fallo en el
acceso a BD", marcamos la opción Privada para que el error solo se pueda ver por los
integrantes del proyecto,opcionalmente podemos poner en Descripción el error con mas
detalles. En estado podemos especificar el estado en que se encuentra la tarea, la
dejamos como Nueva, en Prioridad se escoge Urgente porque el error tiene que estar
solucionado lo antes posible, en versión prevista especifica la versión en que el error
será solucionado, escogemos versión 0.1, en Asignado a, David decide que Alfonso se
encargue de corregir el error. En el apartado de fechas se especifica la fecha de
inicio,automáticamente coge la fecha actual, y podemos especificar una fecha final,
también se puede especificar el tiempo que vamos a utiliza realizar la petición. Por último
podemos especificar algún fichero y escoger los seguidores de la petición. Pulsamos en
Crear.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 13/19

Como este error se ha asignado a Alfonso, en su ordenador Alfonso se conecta a

Redmine con su login y contraseña. Para acceder a la petición que se le ha asignado
dentro del proyecto rooteando en el apartado Peticiones se muestra la lista de peticiones
abiertas .

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 14/19

Pulsamos en la petición y se muestra con mas detalle. Como Alfonso esta trabajando
para corregir el error, decide cambiar el estado de la petición a En curso, para realizar
esto debe pulsar dentro de la petición en el enlace de Actualizar para modificar la
petición.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 15/19

En la lista desplegable de Estado escogemos En curso y pulsamos Aceptar. El estado de

la petición ha cambiado,ahora si nos vamos a Peticiones veremos que el estado de la
petición ha cambiado.

Cuando Alfonso ha corregido el error decide cerrar petición para indicar que ha
corregido en error. Para realizar esto volvemos a ir a la lista de peticiones, nos situamos
en la petición y pulsamos en el botón derecho del ratón, aparecerá un nuevo menú y
dentro de él nos vamos a Estado y pulsamos en cerrada.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 16/19

La petición desaparecerá, si nos vamos al apartado de Actividad que muestra todo lo

que ha ocurrido en el proyecto rooteando, veremos que el error ha sido cerrado.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 17/19

David crea la segunda petición que es una tarea, se crea igual que en la petición de error
pero escogiendo en el tipo Tareas , todas las demás opciones son las mismas que para
crear una petición de error. El resultado de la petición se muestra a continuación.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 18/19

Pulsamos en Crear y la petición esta creada, se puede mirar la petición en el apartado de

Actividad. También podemos ver todas las peticiones en Planificación, que nos muestra
de forma gráfica la evolución de todas las peticiones para las distintas versiones.

En el apartado Calendario podemos ver de forma cronológica todas las peticiones y los
cambios de estado, si cambiamos la opción de abierta por todos se mostraran todos los
estados que ha tenido una petición.

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License
Rooteando Blog 19/19

Si nuestro proyecto es público es aconsejable utilizar el apartado de Noticias donde

podemos informar del estado del proyecto,futuras versiones u otras noticias.

Redmine dispone de un W iki donde podemos centralizar toda la documentación del

proyecto, howto u otra información que puede ser interesante para los desarrolladores
o usuarios.

Con esto finaliza este pequeño tutorial sobre Redmine, se ha visto una parte pequeña de
todo lo que se puede hacer con Redmine.

Enlaces

Taskwarrior : Proyecto gestionado con Redmine, una forma de ver como funciona en
un proyecto real.

http://www.redmine.org/projects/redmine/wiki/Guide : Documentación oficial.

http://qugstart.com/blog/ruby-and-rails/setup-a-git-repository-for-redmine/:
Configuración de un repositorio Git en Redmine.

http://lordsauron.wordpress.com/2008/06/18/zero-to-redmine-in-22-steps/ : Instalación
de Redmine, es algo antiguo, también muestra como instalar y configurar un
balanceador de carga para Redmine, Mongrel.

http://jou-tu.blogspot.com/2011/06/instalacion-de-redmine-sobre-debian.html

Blog de J.A. Jimenez Toro, rooteando.com

Contenido esta bajo licencia Creative Commons Reconocimiento No Comercial Sin Obra
Derivada 3.0 Unported License