Despliegue automatizado de Maven

Durante el desarrollo del proyecto, el proceso de despliegue incluye los siguientes pasos:

  • Enviar el código del proyecto al SVN o al repositorio de código y etiquetarlo.
  • Descargar el código fuente completo desde SVN.
  • Construir la aplicación.
  • Almacenar el archivo WAR o EAR de salida de la compilación en una ubicación de red común.
  • Obtener el archivo desde la red y desplegarlo en el sitio de producción.
  • Actualizar la documentación y el número de versión de la aplicación.

Descripción del problema

Normalmente, el proceso de desarrollo mencionado anteriormente involucra a varios equipos. Un equipo puede ser responsable de enviar el código, otro de construir, etc. Es muy probable que, debido a las operaciones manuales y al entorno de múltiples equipos, cualquiera de los pasos pueda fallar. Por ejemplo, la versión anterior no se actualizó en la máquina de red y luego el equipo de despliegue volvió a implementar una versión de compilación anterior.

Solución

La automatización del despliegue se puede lograr combinando las siguientes soluciones:

  • Utilizar Maven para construir y publicar proyectos.
  • Utilizar SubVersion, el repositorio de código fuente, para gestionar el código fuente.
  • Utilizar software de gestión de repositorios remotos (Jfrog o Nexus) para gestionar los archivos binarios del proyecto.

Modificar el pom.xml del proyecto

Usaremos el complemento de publicación de Maven para crear un proceso de publicación automatizado.

Por ejemplo, el código del archivo pom.xml del proyecto bus-core-api es el siguiente:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>bus-core-api</groupId> <artifactId>bus-core-api</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <scm> <url>http://www.svn.com</url> <connection>scm:svn:http://localhost:8080/svn/jrepo/trunk/ Framework</connection> <developerConnection>scm:svn:${username}/${password}@localhost:8080: common_core_api:1101:code</developerConnection> </scm> <distributionManagement> <repository> <id>Core-API-Java-Release</id> <name>Release repository</name> <url>http://localhost:8081/nexus/content/repositories/ Core-Api-Release</url> </repository> </distributionManagement> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-release-plugin</artifactId> <version>2.0-beta-9</version> <configuration> <useReleaseProfile>false</useReleaseProfile> <goals>deploy</goals> <scmCommentPrefix>[bus-core-api-release-checkin]-< /scmCommentPrefix> </configuration> </plugin> </plugins> </build> </project>

En el archivo pom.xml, algunos de los elementos nodo importantes que se utilizan con frecuencia se muestran en la siguiente tabla:

Elemento nodo Descripción
SCM Configura la ruta de SVN, desde la cual Maven descargará el código.
repository La ubicación del archivo WAR, EAR o JAR construido, u otra ubicación de almacenamiento de los artefactos generados después de una construcción exitosa del código fuente.
Plugin Configura el complemento maven-release-plugin para implementar el proceso de despliegue automático.

Complemento Maven Release

Maven utiliza el complemento maven-release-plugin para realizar las siguientes tareas:

mvn release:clean

Limpiar el espacio de trabajo para garantizar que el proceso de publicación más reciente se ejecute correctamente.

mvn release:rollback

En caso de que el proceso de publicación anterior no haya tenido éxito, revertir el código y la configuración del espacio de trabajo modificados para garantizar que el proceso de publicación se realice correctamente.

mvn release:prepare

Realizar varias operaciones:

  • Verificar si hay cambios locales no confirmados.
  • Asegurarse de que no haya dependencias de instantáneas (snapshot).
  • Cambiar la información de versión de la aplicación para la publicación.
  • Actualizar el archivo POM en SVN.
  • Ejecutar casos de prueba.
  • Confirmar (commit) el archivo POM modificado.
  • Etiquetar el código en SVN.
  • Incrementar el número de versión y adjuntar una instantánea (snapshot) para publicaciones futuras.
  • Confirmar el archivo POM modificado en SVN.
mvn release:perform

Cambiar el código al lugar previamente etiquetado y ejecutar el objetivo de despliegue de Maven para desplegar el archivo WAR o construir la estructura correspondiente en el repositorio.

Abre la terminal de comandos, dirígete al directorio C:\ > MVN >bus-core-api y ejecuta el siguiente comando mvn.

C:\MVN\bus-core-api>mvn release:prepare

Maven comienza a construir todo el proyecto. Una vez que la construcción se complete con éxito, puedes ejecutar el siguiente comando mvn.

C:\MVN\bus-core-api>mvn release:perform

Después de una construcción exitosa, puedes verificar si el archivo JAR cargado en tu repositorio está efectivamente disponible.

Otras extensiones