Gestión de peticiones, wiki y pages con GitLab

Publicado por pico.dev el .
blog-stack planeta-codigo software software-libre
Comentarios

GitLab

Una de las cosas que me gustan de GitLab es que se puede usar en un servidor propio, la otra cosa que me gusta es que incluye varias herramientas casi imprescindibles para cualquier proyecto como gestión de peticiones para recoger las historias, wiki como documentación e información y pages para generar pequeños sitios web además de los repositorios de Git o el servidor de integración y entrega continua. Que GitLab incluya por defecto todas estas herramientas hace innecesario recurrir en la mayoría de los casos a varias herramientas especializadas que cubran estas necesidades como JIRA, Jenkins, MediaWiki o un servidor web para los sitios web.

Después de instalar GitLab usando Docker o de alguna de sus otras formas, creado un usuario no administrador y un proyecto se puede empezar a usar las herramientas de gestión de incidencias, wiki y pages. Estas son solo tres de sus herramientas incluidas, además incluye integración y entrega continua.

Gestión de peticiones

La herramienta de gestión de peticiones permite crear historias que recojan las tareas a realizar, las historias pueden ser de diferente tipo como nuevas funcionalidades, mejoras técnicas o errores, es posible asignarlas a diferentes usuarios, relacionar peticiones entre si o incluir documentos adjuntos. Las historias también se pueden mostrar en un panel Kanban para visualizar el estado de las peticiones, las que están realizándose, las desplegadas en producción, las siguientes peticiones y donde puede haber cuellos de botella en los procesos. El flujo y el panel Kanban que siguen las peticiones desde que se crean hasta que se dan por terminadas es personalizable.

Para crear una nueva petición hay que acceder en el proyecto a Issues y pulsar el botón New Issue. Rellenados los datos del formulario de creación se puede consultar desde Issues > List para verlas en formato lista o Issues > Board para verlas en formato panel Kanban. El panel Kanban se puede modificar y asignando etiquetas a las peticiones crear columnas adaptado al flujo de trabajo de una organización. Con formato de las descripciones de las peticiones permite hacer referencia a otras o incluir menciones a otros usuarios.

Nueva petición
Lista de peticiones y etiquetas
Panel Kanban

Wiki

Una wiki ayuda a recoger información útil en el mismo proyecto pero no en el repositorio de código fuente, por ejemplo, cómo iniciar la aplicación de un proyecto a partir del repositorio de código fuente, qué dependencias tiene como el JDK o una base de datos. También puede recoger información general de lógica de negocio que no cambien tan a menudo como el código como pudiera ser un esquema de alto nivel de arquitectura o por que se han tomado algunas descisiones en la arquitectura y los requerimientos.

Cuando se accede por primera vez a la wiki se crea la página de inicio que se puede editar o crear nuevas páginas. Las páginas de la wiki se escriben en formato Markdown y se guarda un historial de las ediciones que se han realizado a cada página.

Nueva página y página

Pages

La herramienta de pages o páginas permite crear un pequeño sitio web. Se pueden utilizar varias de las herramientas generadoras de sitios web estáticos como Jekyll o Hugo. Para crear un sitio web hay que crear un repositorio de código fuente con un archivo .gitlab-ci.yml y una tarea de nombre pages que contiene los comandos para construir el sitio web.

Es posible asignar a los sitios web de pages un dominio propio y añadirles seguridad con el protocolo HTTPS. En estos repositorios hay ejemplos de como generar un sitio web del proyecto con varios de los más populares generadores de sitios web estáticos. Dependiendo de si el sitio web es para el proyecto o del usuario o grupo el sitio estará accesible en la dirección u otra.

En resumen, ya con esta pequeña serie de artículos queda claro que GitLab es una herramienta muy completa y que incluye las funcionalidades de varias que son suficientes para la mayoría de los casos sin tener que recurrir a Jira, Jenkins, MediaWiki o un servidor web. Además, con la muy completa API de GitLab es posible hacer desarrollos a medida y según las necesidades que se tengan.

El código fuente completo del ejemplo puedes descargarlo del repositorio de ejemplos de Blog Bitix alojado en GitHub y probarlo en tu equipo ejecutando el comando docker-compose -f docker-compose-all.yml up.