Maven Releaser es una herramienta opensource desarrollada por empleados de Mercury en su tiempo libre para cubrir la necesidad de liberaciones rapidas de todas la maraña de dependencias que se desprenden de los proyectos Maven.
Permite el analisis de un pom de partida en que encuentra todas sus dependencias y de forma escalonada liberarlas en el orden que lo exija el arbol de dependencias.
También permite verificar los commits que se hacen a svn o git para que el codigo fuente que se sube está correctamente relacionado en jira con los artefactos correspondientes
Una vez invocado, se explora el pom.xml del proyecto indicado en busca de dependencias que se encuentren subfijadas con el apellido SNAPSHOT. Para cada una de estas que se encuentren se busca dicho artefacto en el repositorio de MercuryTFS (artifactory) en lo repositorios de versiones cerradas (tanto comun como de proyecto) en busca de una version liberada:
- De no encontrarse se trata de buscar una version en el repositorio de versiones SNAPSHOT (tanto comun como de proyecto)
- De encontrarse en el repositorio de SNAPSHOTS de Artifactory, se descarga y analiza de la misma manera que al padre que lo encontró
- De no encontrarse en el repo SNAPSHOTS se le supone una dependencia externa y se le obvia.
- De encontrarse se actualiza el pom eliminando el sufijo SNAPSHOT en tanto se entiende no procede.
Con el resultado de estas búsquedas se actualiza el POM analizado y se respalda en el servidor para proceder a lanzar el plugin maven-release, este baja una copia del código para comprobar que compila correctamente, hace un tag en el repositorio de código y avanza el numero de versión del pom. Este numero nuevo de version será preguntado al operador conforme se continuen las liberaciones. Se puede indicar la version del artefacto en ciernes a liberar ademas de la version siguiente separadas por @
Indica que la siguiente version será la 1.10.0 y que el pom que está procesando se debe cerrar y desplegar como 1.9.1
Para lanzarlo se debe ejecutar como jar en un sistema en que se tenga correctamente configurado la invacion de Maven (esto es, con un settings.xml que se conozca es correcto)
$ java -jar mavenreleaser-4.0.0.jar --username aUser --url http://gitlab.mercurytfs.com/aMightyArtifact -- artefactName aMightyArtifact --action prepareEl ejecutable cuenta con 4 parámetros obligatorios, a saber
- url La ruta en que se aloja el codigo fuente del artefacto a liberar
- username El usuario con que conectar al repositorio de código
- artefactName El nombre que se le va a dar al artefacto en la sesión (no será el que se le aplique en la subida)
- action Que tipo de acción se desea llevar a cabo, prepare para analizar el arbol de dependencias o release para liberar el artefacto completo y todas las dependencias que de el se desprenden.
A mayores de estas se puede indicar como parámetros opcionales
- password La contraseña del usuario indicado, útil para labores de autimatizacion
- jira Jira asociado al artefacto para el tratamiento del flujo operativo
- maven.java.home Para indicar el 'java home' con el que se ejecutara maven, por ejemplo para poder compilar con el jdk 11
Se pueden indicar algunas de las variables de configuracion por linea de comando con argumentos -D en la invocacion.
- Los repositorios GIT se le puede indicar el branch a usar en lugar de master con la propiedad git.branch (desde la version 4.3.4).
$ java -Dgit.branch=MIBRANCH -jar mavenreleaser-4......
- Las direcciones de los repositorios de Artifactory se indican con las propiedades repository.url y repository.url.legacy, actualmente apuntan a http://192.168.10.9:8082/artifactory/ y http://192.168.10.2:8081/artifactory/ respectivamente. Opcionalmente, desde la versión 4.8.0, se puede indicar el parámetro useLegacy=true para activar el repositorio legacy.
$ java -DuseLegacy=true -jar mavenreleaser-4......
- Los repos internos de artifactory comunes se definenen mediante repository.release.main, repository.snapshot.main y repository.snapshot.trunk (por defecto apuntan a libs-release-local, libs-snapshot-local y libs-trunk-snapshots-local)
- Los repos internos de artifactory especificos de proyecto se definenen mediante repository.release.project, repository.snapshot.project (por defecto apuntan a santander-gts-libs-release-local y santander-gts-libs-trunk-local)
- No es compatible con Java 11. Es requisito sine qua non lanzar Maven Releaser con Java 8
- Este proyecto requiere de soporte Lombok si se quiere importar a un IDE