Manual de uso Redmine.pdf

2013

David Soto Mateluna

Centro de Innovacin y transferencia

tecnolgica - DUOC UC

19/08/2013

Redmine Manual para el usuario

Redmine manual de usuario Pgina 2

1. ndice

2. Introduccin. ......................................................................................................................... 3

3. Caractersticas de la plataforma ............................................................................................ 4

3.1 Manejo de usuarios ....................................................................................................... 4

3.2 Proyectos ....................................................................................................................... 6

3.3 Informes ...................................................................................................................... 10

3.4 Mi pgina ..................................................................................................................... 12

3.5 Horas y avance ............................................................................................................ 12

3.6 Buscador global ........................................................................................................... 13

3.7 Preferencias de usuario ............................................................................................... 13

3.8 Administracin del sistema ......................................................................................... 14

3.9 Calendario ................................................................................................................... 15

4. Medidas de seguridad de la infraestructura ....................................................................... 16

4.1 Funciones y obligaciones del personal(usuarios) ........................................................ 16

4.2 Control de acceso ........................................................................................................ 16

4.3 Identificacin y autenticacin ..................................................................................... 16

5. Caso de ejemplo para utilizar Redmine .............................................................................. 17

5.1 primeros pasos ............................................................................................................ 17

5.2 Creacin de proyectos ................................................................................................. 19

5.3 Integracin con Git (Repositorio de Versiones) .......................................................... 22

5.4 Peticiones .................................................................................................................... 24

5.5 Calendario ................................................................................................................... 29

6. Conclusin ........................................................................................................................... 30

7. Enlaces ................................................................................................................................. 30


2. Introduccin.

Este manual pretende ser una gua en el uso del gestor proyectos Redmine. En su

contenido podremos observar los aspectos ms esenciales para poder utilizar de una

manera muy fcil esta.

Redmine es un gestor de proyecto escrito en Ruby on Rails de cdigo abierto de

extendido uso, tanto en el mbito pblico como el privado, y destinada a facilitar el

control y seguimiento de proyectos, canalizando la comunicacin entre los distintos

actores participantes y ofreciendo adems un amplio abanico de posibilidades de

personalizacin.

Adems este nos permite administrar a los usuarios del proyecto, los errores con un

sistema de tickets, wiki, calendario...etc. Tiene integracin con diversos sistemas de

control de versiones como SVN, CVS, Git, Mercurial, Bazaar y Darcs.


3. Caractersticas de la plataforma

3.1 Manejo de usuarios

Redmine permite asignar distintos miembros y cargos a un proyecto. Inicialmente se identifican 4 roles principales , sobre los que se modelar la poltica de permisos y restricciones de acceso, tanto a informacin como a herramientas (informes, dedicacin, etc). A continuacin se propone un escenario de capacidades que, en cualquier caso, ser consensuado con la Direccin del Proyecto antes de su implantacin.

Administrador de Directores de proyecto: dispone de todos los privilegios de gestin de la plataforma.

Responsable de la administracin general del sistema.

Dispone de acceso a datos agregados sobre mltiples proyectos, como dedicacin, avance, etc. as como cualquier otro indicador mediante el

mdulo de generacin de informes.

Puede aadir nuevos proyectos y sub proyectos (ilimitado)

Puede gestionar (aadir, borrar, habilitar-deshabilitar) usuarios sin lmite.

Pleno acceso y gestin de parmetros de los proyectos.

Pleno acceso a la gestin de actividades y sub actividades de los proyectos.

Pleno acceso a la gestin de privilegios y flujos de trabajo asociados a cada tipo de actividad.

Administrador de proyectos: su mbito de actuacin queda reducido a un

proyecto o conjunto de proyectos de los que es responsable.

Puede asignar recursos (usuarios) ya existentes a un proyecto.

Establece el cargo.

Pleno acceso a la generacin de informes sobre actividad en el mbito.

de los proyectos que le estn asignados.


Usuarios: personal disponible que participa en proyectos con distintos niveles

de responsabilidades. En funcin de las necesidades que se identifiquen, se

modelaran distintos perfiles/cargos de usuario atendiendo al papel que

desempean en los proyectos.

Stakeholders:

Participan de forma puntual en proyectos.

Cuentan con acceso limitado a la informacin.


3.2 Proyectos

El mdulo de administracin de Redmine permite gestionar fcilmente mltiples proyectos. A travs de una interfaz de usuario sencilla, el sistema permite archivar eliminar, archivar y realizar bsquedas sobre el listado de proyectos, as como dar de alta nuevos proyectos y sub proyectos. El primer paso para la creacin de un nuevo proyecto es la introduccin de los detalles particulares del proyecto. Datos como cliente/departamento, descripcin, presupuesto y miembros que van a participar son algunos de los ejemplos ms claros.

Esta informacin es suministrada por el Administrador de proyecto al que se ha asignado y est disponible para su consulta y/o modificacin posterior a travs de la pestaa configuracin (de acceso est restringido a los perfiles anteriores).


El administrador del proyecto podr seleccionar adems entre el conjunto de disponibles en la plataforma de forma opcional para adecuarla a las necesidades del nuevo proyecto.

Entre estas herramientas se encuentran:

Tabln de noticias.

Control de tiempo.

Documentos.

Ficheros.

Cuadro de mtricas.


El proyecto ya est registrado y dispone de un conjunto de herramientas. El siguiente paso ser incorporar a las personas que participarn de forma directa en la realizacin de tareas. Una vez formalizada la creacin del nuevo proyecto y configurados los detalles sobre mdulos, miembros, etc.se puede dar paso a la creacin de tareas y sub tareas que lo componen.

Redmine permite establecer distintas categoras, facilitando as el seguimiento de actividades al contar con mayor granularidad, adems de permitir la personalizacin de atributos de informacin asociados a cada tipo de actividad. A continuacin se recoge la informacin bsica a cada tarea.


El sistema permite adems vincular dos o ms tareas en base a distintos tipos de relacin, concretamente:

Tarea A es duplicada de B.

A bloquea B.

A es una sub tarea de B.

A es anterior a B.

Cada tarea registra el historial de trabajo a modo de bitcora, facilitando el seguimiento y la evaluacin de acciones realizadas desde su creacin hasta el cierre. Redmine ofrece la posibilidad de exportar esta informacin en formato imprimible (pdf) as como aadir la informacin a un canal de feeds.


3.3 Informes

Redmine con una potente herramienta de generacin de informes que permitir sacar el mayor partido a la informacin recogida en la plataforma Distinguimos entre tres tipos de informes:

Informes de actividad y dedicacin al proyecto: tienen como finalidad la de obtener informacin sobre tiempo dedicado a las distintas actividades del proyecto de forma sencilla y en base a distintos criterios fcilmente personalizables. La herramienta permite adems exportar los resultados a formato de hoja de clculo (CSV).


Informes de situacin sobre tareas, estado y avance: permite generar informes personalizados en base a cualquier criterio o criterios de seleccin. El sistema permite adems almacenar El resultado de estos informes puede exportarse.


3.4 Mi pgina

La pgina personal de cada usuario puede ser personalizada fcilmente, aadiendo nuevos bloques de informacin y organizndolos mediante drag & drop, accediendo a informacin sobre proyectos, tareas, noticias y comunicaciones, actividad reciente, informes y notas.

3.5 Horas y avance

Redmine permite conocer el avance del proyecto tomando como punto de partida el esfuerzo estimado e incurrido a nivel de tarea.


3.6 Buscador global

El motor de bsqueda facilita la localizacin de informacin relativa a proyectos,

tareas, usuarios, noticias y documentos.

3.7 Preferencias de usuario

Las preferencias de usuario (nombre, apellido, direccin de correo a efectos de notificacin, nivel de notificacin) son fcilmente configurables a travs de Mi cuenta. Las notificaciones llegan de forma automtica a travs de correo electrnico, indicando en el asunto el nombre de proyecto, cdigo de tarea e informacin sobre la notificacin (cambio de estado, nueva tarea, nuevo comentario).


3.8 Administracin del sistema

El usuario administrador dispone de un panel a travs del cual gestionar los principales parmetros de la plataforma, como la gestin de usuarios, grupos y perfiles. La gestin de usuarios se realiza a travs de un cmodo listado a travs del cual se puede buscar a un usuario a travs del buscador, modificar sus preferencias, aadir o eliminar nuevos usuarios. Este mismo registro muestra la antigedad de los usuarios, as como el registro de acceso a la plataforma.

Un mismo usuario puede desempear distintas funciones dependiendo del proyecto. Para facilitar la gestin de cargos.

Una de las herramientas ms verstiles proporcionadas es la de personalizacin de flujos de trabajo. A travs de esta herramienta es posible modelar de forma sencilla el proceso de trabajo en el da a da de los proyectos. Para ello, Redmine permite asignar flujos de trabajo en base a cargo, tipo de actividad y estado de las peticiones/tareas.


3.9 Calendario

El mdulo de calendario permite consultar las actividades planificadas y asignadas a cada usuario, as como hitos relevantes del proyecto o cualquier otro tipo de evento, facilitando la tarea de planificacin de tareas y reuniones, y la gestin ms eficiente de los recursos disponibles. Mediante el uso de la extensin "Periodic Tasks" se incluye la posibilidad de programar actividades peridicas (reuniones de seguimiento, auditoras, etc.).


4. Medidas de seguridad de la infraestructura

4.1 Funciones y obligaciones del personal(usuarios)

Como primera medida bsica, se propone realizar una relacin de perfiles que por alguna razn justificada, necesiten acceso a los sistemas de informacin del proyecto. Es decir, se debe crear una relacin de:

Los perfiles o personas que requieran algn tipo de acceso.

La relacin de sistemas de informacin a los que tienen acceso.

El nivel de acceso (acceso de lectura, acceso de modificacin, etc.).

4.2 Control de acceso

No slo se deber tener una relacin de los accesos para que los perfiles adecuados tengan claros sus permisos, tambin se pondrn los medios para que los usuarios slo tengan acceso a los recursos que precisen para el desarrollo de sus funciones.

4.3 Identificacin y autenticacin

El proceso de identificacin deber garantizar tener un nivel de seguridad ptimo. El mecanismo deber permitir la identificacin de forma inequvoca y personalizada de todo aquel usuario que intente acceder al sistema de informacin y la verificacin de que est autorizado. Las contraseas de los sistemas de identificacin debern ser almacenadas, distribuidas y asignadas garantizando la confidencialidad e integridad. Para tal fin, se utilizarn sistemas de cifrado de contraseas a la par de conexiones seguras en el proceso de identificacin. Adems, se introducir una medida de nivel medio que limite el nmero de posibilidades de introducir la contrasea incorrecta. Gracias a esta medida se anular el xito de cualquier ataque por fuerza bruta.


5. Caso de ejemplo para utilizar Redmine

5.1 primeros pasos

Nota: Para poner en prctica este caso de ejemplo debes ejecutar el archivo redmine-

livedemo-0.4.2-win32 e ir a la siguiente direccin: http://localhost:3000/

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 Juan, tienen un repositorio Git donde tienen el cdigo del

proyecto. En Redmine realizaremos las siguientes tareas:

Juan ser el jefe de proyecto y le asignaremos ese rol en Redmine, utilizara la

cuenta de "administrador" 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 est instalado y funcionando, Juan se encuentra en la pantalla inicial de

Redmine, ver imagen anterior, pulsamos en Conexin. Como es la primera vez que nos

conectamos ,el identificador es "admin" y la contrasea es "admin". De esta forma

tendremos acceso al usuario administrador que tiene todos los permisos asignados, lo

primero es cambiarle la contrasea por defecto. En la parte superior de la pgina

tenemos varios opciones, una de ella es Administracin.


Donde podemos administrar las diferentes aspectos de Redmine. Pulsamos en la opcin de Usuarios, donde se mostrara una lista de los usuarios, ahora solo tenemos el usuario "admin", este usuario ser el que utilice Juan aunque podra crear un usuario con privilegios de administrador. Pulsamos en el usuario "admin" para que muestre todos los atributos que este posee.

Prcticamente todos los cuadros estn etiquetados de forma muy clara con lo que no tienen mucha explicacin, es posible que tengas que cambiar el idioma a espaol. Escribimos una nueva direccin de correo electrnico en el cuadro de Informacin y pulsamos en el botn de Guardar.


5.2 Creacin de proyectos

Lo siguiente es crear un proyecto nuevo, sin salir de la pgina anterior en la parte derecha pulsamos en Proyectos. En la pgina 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 descripcin opcional y un identificador. Si dejamos la opcin de Pblico marcada el proyecto ser visible para todo el mundo, si la desmarcamos ser obligatorio hacer "Login o inicio de sesin" para ver el proyecto. En el apartado de Mdulos, se eligen los mdulos que estarn disponibles para el proyecto y en Peticiones decidimos que tipo de peticiones estarn disponibles, Juan marca todas las opciones. Pulsamos en Guardar y ya est creado el proyecto. Desde este momento en el apartado Proyecto de la opcin aparecer en la lista de proyectos rooteando, ahora habr que asignarle usuarios al proyecto, en principio ser el usuario Juan, que ser el usuario "admin", y despus 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 seccin de Administracin pulsamos en Proyectos, ahora se ver el proyecto creado anteriormente, pulsamos en el "proyecto rooteando". Se mostrara el apartado de Configuracin para el proyecto , en la parte superior veremos una serie de pestaas con diferentes opciones que podemos configurar. Pulsamos en la pestaa Miembros.

En esta pestaa 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 Juan, y tres perfiles, en este caso marcamos el usuario "admin" , el perfil Jefe de proyecto y pulsamos en Aadir. Juan 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 opcin Administracin->Perfiles y permisos. Se mostraran todos los perfiles disponibles, incluso podremos crear nuevos perfiles pulsando en Nuevo perfil, si pulsamos en informes de permisos.

Tenemos la lista de permisos activados para cada perfil, se puede personalizar cada perfil marcando y desmarcando en los permisos. Juan crea el usuario Alfonso que le asignara el perfil de Desarrollador, dentro de Administracin pulsamos en Usuarios, Nuevo usuario, se rellenan los datos para Alfonso y para finalizar se pulsa en Crear. Ahora se ver una pestaa nueva, Proyectos, que servir para asignar proyectos al usuario creado, seleccionamos en Nuevo "proyecto a rooteando" y en perfil escogemos Desarrollador y aadimos el usuario. Ahora tenemos dos usuario, Juan y Alfonso, que tiene asignado el "proyecto rooteando" y diferentes perfiles, jefe de proyecto y desarrollador.


5.3 Integracin con Git (Repositorio de Versiones) Juan y Alfonso ya han comenzado el proyecto de rooteando y tienen un repositorio Git con el

cdigo del proyecto. Lo que quieren es integrar Redmine con el repositorio Git, de esta forma

Redmine tendr acceso al cdigo. Redmine permite integrar repositorios de diferentes

sistemas de control de versiones como Subversion, Git, Baazar, Mercurial...etc.

Para integrar el repositorio , accedemos como "admin1", pulsamos en el apartado Administracin, Proyectos y escogemos el proyecto rooteando. Accederemos a la pgina de Configuracin de rooteando, pulsamos en la pestaa 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 codificacin la dejamos por defecto y marcamos la ltima opcin 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 pgina de Repositorio para que se muestren.


Ahora se vern 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 ms detalle e incluso ver las diferencias entre versiones. En la parte de arriba tenemos la opcin de Estadsticas donde veremos dos grficos, unos para los commits y el otro muestra los "commit" por usuario, otra opcin es Ramas que muestra las diferentes ramas que tenga el repositorio Git. El repositorio tiene dos ramas, "master" donde se almacena la versin estable del proyecto y la rama desarrollo donde Juan y Alfonso trabajan habitualmente, cuando una versin de esta rama se considera estable se fusiona con la rama "master". Si nos vamos a la opcin de Ramas de Redmine y escogemos la rama de desarrollo.


En esta rama tenemos ms "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 dems opciones explicadas para la rama "master" son aplicables en esta rama.

5.4 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 versin especifica del proyecto. Empecemos con esto ltimo, Juan (el jefe de proyecto) ha considerado que proyecto ha alcanzado la versin 0.1, con lo que crea una nueva versin en Redmine. Nos vamos al apartado de Configuracin y escogemos la pestaa Versin, aparece un enlace de Nueva versin, pulsamos en el enlace.

Primero definimos el nombre de versin ,en este caso Juan escoge Versin 0.1 una descripcin "Primera versin estable del proyecto rooteando", escogemos el estado de la versin, como es la versin con que vamos a trabajar dejamos el estado abierto. como no cuenta con una pgina de wiki lo dejamos en blanco, escogemos la fecha actual (pulsar el botn que se encuentra a la derecha para especificar la fecha) y la ltima opcin Compartir la dejamos por defecto. Pulsamos en Crear ya tenemos creada la primera versin de rooteando. Juan crea dos peticiones en la versin 0.1, la primera ser un error que hay que corregir urgentemente y la segunda es una peticin de tipo tarea para aadir una nueva caracterstica al proyecto .


Nos vamos al apartado de Nueva peticin, escogemos el tipo Error y el Tema "fallo en el acceso a BD", marcamos la opcin Privada para que el error solo se pueda ver por los integrantes del proyecto, opcionalmente podemos poner en Descripcin el error con ms 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 versin prevista especifica la versin en que el error ser solucionado, escogemos versin 0.1, en Asignado a, Juan decide que Alfonso se encargue de corregir el error. En el apartado de fechas se especifica la fecha de inicio, automticamente coge la fecha actual, y podemos especificar una fecha final, tambin se puede especificar el tiempo que vamos a utiliza realizar la peticin. Por ltimo podemos especificar algn fichero y escoger los seguidores de la peticin. Pulsamos en Crear. Como este error se ha asignado a Alfonso, en su ordenador Alfonso se conecta a Redmine con su "usuario y contrasea". Para acceder a la peticin que se le ha asignado dentro del proyecto rooteando en el apartado Peticiones se muestra la lista de peticiones abiertas .


Como este error se ha asignado a Alfonso, en su ordenador Alfonso se conecta a Redmine con su usuario y contrasea. Para acceder a la peticin que se le ha asignado dentro del proyecto rooteando en el apartado Peticiones se muestra la lista de peticiones abiertas.

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


En la lista desplegable de Estado escogemos En curso y pulsamos Aceptar. El estado de la peticin ha cambiado, ahora si nos vamos a Peticiones veremos que el estado de la peticin ha cambiado. Cuando Alfonso ha corregido el error decide cerrar peticin para indicar que ha corregido en error. Para realizar esto volvemos a ir a la lista de peticiones, nos situamos en la peticin y pulsamos en el botn derecho del ratn, aparecer un nuevo men y dentro de l nos vamos a Estado y pulsamos en cerrada.

La peticin 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.


Juan crea la segunda peticin que es una tarea, se crea igual que en la peticin de error pero escogiendo en el tipo Tareas, todas las dems opciones son las mismas que para crear una peticin de error. El resultado de la peticin se muestra a continuacin.

Pulsamos en Crear y la peticin esta creada, se puede mirar la peticin en el apartado de Actividad. Tambin podemos ver todas las peticiones en Planificacin, que nos muestra de forma grfica la evolucin de todas las peticiones para las distintas versiones. En el apartado Calendario podemos ver de forma cronolgica todas las peticiones y los cambios de estado, si cambiamos la opcin de abierta por todos se mostraran todos los estados que ha tenido una peticin.


5.5 Calendario

Si nuestro proyecto es pblico 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 documentacin del proyecto,

"how to" u otra informacin que puede ser interesante para los desarrolladores o usuarios.

Con esto finaliza este pequeo tutorial sobre Redmine, se ha visto una parte pequea de todo

lo que se puede hacer con Redmine.


6. Conclusin

Redmine nos puede ayudar en gran medida a gestionar de manera gil todos los

proyectos de nuestra empresa, la documentacin asociada, los archivos que anexamos

y todo ello controlando en cada momento la ejecucin del mismo. Su administracin

es sencilla y permite definir flujos de trabajo que evitarn que la gestin nos inunde la

bandeja de entrada con un correo por cada pequeo detalle a discutir en el mismo.

Para probarlo tenemos la opcin de descargarlo e instalarlo a travs de un archivo

".exe" que nos permitir probarlo de forma fiable en local para despus si lo

consideramos adecuado llevarlo al servidor de manera que lo ponemos disponible

para todos los usuarios de la empresa. Sin duda merece la pena hacer la prueba.

7. Enlaces http://www.duoc.cl/escuelait/ : Escuela de informtica y telecomunicaciones Duoc UC. http://www.duoc.cl/escuelait/citt/ : Centro de innovacin y transferencia tecnolgica de Duoc UC(Donde se implementara esta plataforma). http://www.redmine.org/projects/redmine/wiki/Guide : Documentacin oficial. http://qugstart.com/blog/ruby-and-rails/setup-a-git-repository-for-redmine/: Configuracin de un repositorio Git en Redmine.

Manual de uso Redmine.pdf

Documents

Transcript of Manual de uso Redmine.pdf