Redmine, gestor de proyectos by kotov - Jueves, junio 23, 2011 http://rooteando.com/redmine-gestor-de-proyectos/ Kindle 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 forma 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. 1 / 12
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 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: 2 / 12
David sera el jefe de proyecto y le asignaremos ese rol en Redmine, utilizara la 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. 3 / 12
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. 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. 4 / 12
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. 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. 5 / 12
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. 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. 6 / 12
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. 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 7 / 12
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. 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. 8 / 12
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. 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. 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. 9 / 12
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. 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. 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. 10 / 12
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. 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 Wiki 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. 11 / 12
Powered by TCPDF (www.tcpdf.org) Redmine, gestor de proyectos - 06-23-2011 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 PDF generated by Kalin's PDF Creation Station 12 / 12