Déploiement automatisé avec Maven

Pendant le développement du projet, le processus de déploiement comprend les étapes suivantes :

  • Validez tout le code du projet dans SVN ou un dépôt de code et étiquetez-le.
  • Télécharger le code source complet depuis SVN.
  • Compiler l'application.
  • Stocker les fichiers WAR ou EAR générés à un emplacement réseau commun.
  • Récupérer les fichiers depuis le réseau et les déployer sur le site de production.
  • Mettre à jour la documentation et mettre à jour le numéro de version de l'application.

Description du problème

Habituellement, le processus de développement mentionné ci-dessus implique plusieurs équipes. Une équipe peut être responsable de la validation du code, une autre de la compilation, et ainsi de suite. Il est très probable qu'une étape quelconque puisse mal tourner en raison des opérations manuelles et de l'environnement multi-équipes impliqué. Par exemple, une version plus ancienne n'est pas mise à jour sur la machine réseau, puis l'équipe de déploiement redéploie une version de compilation antérieure.

Solution

Obtenir un déploiement automatisé en combinant les approches suivantes :

  • Utiliser Maven pour compiler et publier les projets
  • Utiliser SubVersion, le dépôt de sources, pour gérer le code source
  • Utiliser un logiciel de gestion de dépôt distant (Jfrog ou Nexus) pour gérer les fichiers binaires du projet.

Modifier le fichier pom.xml du projet

Nous utiliserons le plugin Maven Release pour créer un processus de publication automatisé.

Par exemple, le fichier pom.xml du projet bus-core-api est le suivant :

<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>Dépôt de publication</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> </construction> </projet>

Certains nœuds d'éléments importants couramment utilisés dans le fichier pom.xml sont présentés dans le tableau ci-dessous :

Nœud d'élément Description
SCM Configurer le chemin SVN à partir duquel Maven récupérera le code.
repository L'emplacement des fichiers WAR, EAR ou JAR construits, ou l'emplacement de stockage des autres artefacts générés après une compilation réussie des sources.
Plugin Configurer le plugin maven-release-plugin pour mettre en œuvre le processus de déploiement automatisé.

Maven Release Plugin

Maven utilise le plugin maven-release-plugin pour accomplir les tâches suivantes.

mvn release:clean

Nettoyer l'espace de travail afin de garantir que le processus de publication le plus récent se déroule avec succès.

mvn release:rollback

Si le processus de publication précédent a échoué, annuler les modifications apportées au code et à la configuration de l'espace de travail afin de garantir la réussite du processus de publication.

mvn release:prepare

Effectuer diverses opérations :

  • Vérifier s'il existe des modifications non validées localement
  • S'assurer qu'il n'y a pas de dépendances snapshot
  • Modifier les informations de version de l'application pour la publication
  • Mettre à jour les fichiers POM dans SVN
  • Exécuter les cas de test
  • Valider les fichiers POM modifiés
  • Taguer le code sur SVN
  • Incrémenter le numéro de version et ajouter un snapshot pour les prochaines versions
  • Valider les fichiers POM modifiés dans SVN
mvn release:perform

Basculer le code vers l'emplacement précédemment étiqueté, exécuter l'objectif deploy de Maven pour déployer le fichier WAR ou construire les artefacts correspondants dans le dépôt.

Ouvrez un terminal de commandes, naviguez jusqu'au répertoire C:\ > MVN >bus-core-api, puis exécutez la commande mvn suivante.

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

Maven commence à construire l'ensemble du projet. Après une construction réussie, vous pouvez exécuter la commande mvn suivante.

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

Après une construction réussie, vous pouvez vérifier si le fichier JAR téléversé dans votre référentiel est effectif.

Autres extensions