Maven plugin to deploy Mule applications to different kind of servers: Standalone (both Community and Enterprise), Clustered, Anypoint Runtime Manager and CloudHub. The main uses are to run integration tests and deploy applications to different environments.
-
Deploy a Mule application to a local Standalone server.
-
Run integration tests in a local Standalone deployment.
-
Supports both Community and Enterprise editions.
-
Deploy Mule applications to Anypoint Runtime Manager.
-
Deploy Mule applications to CloudHub.
-
Deploy Mule applications to a local Cluster.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
</plugin>Add this repository to your project or your settings.xml like this:
<pluginRepositories>
<pluginRepository>
<id>mule-public</id>
<url>https://repository.mulesoft.org/nexus/content/repositories/releases</url>
</pluginRepository>
</pluginRepositories>You can download the JAR file manually from here or get if from Maven Central Repository.
In the most simple scenario the plugin will download and install a Mule Standalone server and deploy the result of the Maven build to it:
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<deploymentType>standalone</deploymentType>
<muleVersion>3.7.0</muleVersion>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>-
You need to have the repository where Mule is available properly configured in your settings.xml or in your pom.xml.
-
This will also trigger the default deploy goal of the maven-deploy-plugin. If you are not deploying to a Maven repository as part of your build, you can prevent the plugin execution by using:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-deploy-plugin</artifactId>
<configuration>
<skip>true</skip>
</configuration>
</plugin>You can deploy your application to a running ARM server, serverGroup or cluster. You need to provide the ARM credentials and configure the target name.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<deploymentType>arm</deploymentType>
<username>myUsername</username>
<password>myPassword</password>
<target>server-name</target>
<targetType>server</targetType> <!-- One of: server, serverGroup, cluster -->
<environment>Production</environment>
<url>https://anypoint.mulesoft.com</url>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>To deploy your application to CloudHub:
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<deploymentType>cloudhub</deploymentType>
<muleVersion>3.7.0</muleVersion> <!-- This is the runtime version as it appears on the CloudHub interface -->
<username>myUsername</username>
<password>myPassword</password>
<environment>Production</environment>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>In both CloudHub and Anypoint Runtime Manager deployment you can select a Business Group other than your root Organization. In the example below the plugin is configured to deploy to a business group called devops which is under the engineering business group. If your business group name includes a backslash, you can escape it with backslash.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<configuration>
<deploymentType>cloudhub</deploymentType>
<muleVersion>${mule.version}</muleVersion>
<username>${username}</username>
<password>${password}</password>
<applicationName>my-application</applicationName>
<environment>Production</environment>
<businessGroup>engineering\devops</businessGroup>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>You can make the plugin deploy to an existing Mule server instead of downloading an installing it. Just configure muleHome property like this:
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<deploymentType>standalone</deploymentType>
<muleHome>/path/to/mule/server</muleHome>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>You can make the plugin deploy to an existing Mule server, using the API provided by the Mule Agent:
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<deploymentType>agent</deploymentType>
<uri>http://localhost:9999/</uri>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>The uri parameter is the endpoint of the REST API of the Agent.
One of the most important uses for the plugin is to run integration tests on your integration application. You can see the working example in src/it/standalone/example-integration-tests.
Basically you will configure maven-mule-plugin to pack your project in Mule app format, maven-failsafe-plugin to run integration-tests and report, and this plugin to deploy the project packaged application to a new Mule Server downloaded from a Maven repository.
<plugins>
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-app-maven-plugin</artifactId>
<version>1.1</version>
<extensions>true</extensions>
</plugin>
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<deploymentType>standalone</deploymentType>
<muleVersion>3.7.0</muleVersion>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>pre-integration-test</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
<execution>
<id>undeploy</id>
<phase>post-integration-test</phase>
<goals>
<goal>undeploy</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-failsafe-plugin</artifactId>
<executions>
<execution>
<id>integration-test</id>
<goals>
<goal>integration-test</goal>
<goal>verify</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>In this example, the mule-app-maven-plugin packages the Mule application that is deployed by the mule-maven-plugin.
In this example you will see the plugin working for Standalone deployment, configuring one applications to be deployed, two external libs to be added to the server, a domain to be deployed, and a script to be ran just before starting the server.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<muleVersion>3.7.0</muleVersion> <!--(1)-->
<deploymentType>standalone</deploymentType>
<application>${app.location}</application> <!--(2)-->
<libs>
<lib>${basedir}/activemq-all-5.5.0.jar</lib>
<lib>${basedir}/activemq-core.jar</lib> <!--(3)-->
</libs>
<arguments>
<argument>-M-Dport.1=1337</argument>
<argument>-M-Dport.2=1338</argument> <!--(4)-->
</arguments>
<domain>${project.basedir}/domain</domain> <!--(5)-->
<script>${basedir}/script.groovy</script> <!--(6)-->
<community>false</community> <!--(7)-->
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>pre-integration-test</phase>
<goals>
<goal>deploy</goal> <!--(8)-->
</goals>
</execution>
<execution>
<id>undeploy</id>
<phase>post-integration-test</phase>
<goals>
<goal>undeploy</goal> <!--(9)-->
</goals>
</execution>
</executions>
</plugin>-
Configures Mule version.
-
Either point to a Mule application deployable zip, or an exploded Mule app folder. Defaults to the build generated artifact.
-
External libs to be added to Mule Standalone.
-
Mule arguments (optional).
-
Domain to deploy, to add your application to the domain you must configure your application manually (optional).
-
Optional Groovy script to be executed just before the deployment.
-
Use Enterprise Edition.
-
Use the deploy goal to download Mule, install it and deploy the domain and applications.
-
Use the undeploy goal to undeploy de applications and stop Mule server.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<muleVersion>3.7.0</muleVersion>
<deploymentType>cluster</deploymentType>
<size>2</size> <!--(1)-->
<application>${app.location}</application>
<libs>
<lib>${basedir}/activemq-all-5.5.0.jar</lib>
<lib>${basedir}/activemq-core.jar</lib>
</libs>
<arguments>
<argument>-M-Dport.1=1337</argument>
<argument>-M-Dport.2=1338</argument>
</arguments>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>pre-integration-test</phase>
<goals>
<goal>deploy</goal> <!--(2)-->
</goals>
</execution>
<execution>
<id>undeploy</id>
<phase>post-integration-test</phase>
<goals>
<goal>undeploy</goal> <!--(3)-->
</goals>
</execution>
</executions>
</plugin>It’s pretty much the same as before, but with the following differences:
-
Specify the number of nodes that’ll be used to make the cluster. The plugin then’ll make the cluster for you.
-
In order to start the cluster, you need to specify the clusterDeploy goal.
-
In order to stop the cluster, you need to specify the clusterStop goal.
To deploy more than one application you need to configure one plugin execution for each application to deploy.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>2.0</version>
<configuration>
<muleVersion>3.7.0</muleVersion>
<deploymentType>standalone</deploymentType>
</configuration>
<executions>
<execution>
<id>deploy1</id>
<phase>pre-integration-test</phase>
<goals>
<goal>deploy</goal>
</goals>
<configuration>
<application>${app.1.location}</application>
</configuration>
</execution>
<execution>
<id>deploy2</id>
<phase>pre-integration-test</phase>
<goals>
<goal>deploy</goal>
</goals>
<configuration>
<application>${app.2.location}</application>
</configuration>
</execution>
<execution>
<id>undeploy1</id>
<phase>post-integration-test</phase>
<goals>
<goal>undeploy</goal>
</goals>
<configuration>
<application>${app.1.location}</application>
</configuration>
</execution>
<execution>
<id>undeploy2</id>
<phase>post-integration-test</phase>
<goals>
<goal>undeploy</goal>
</goals>
<configuration>
<application>${app.2.location}</application>
</configuration>
</execution>
</executions>
</plugin>skip when true makes plugin execution to be skipped. This property works with all plugin goals. The most common scenario is to configure its value to skipTests, so, when you don’t want your tests to run, you also don’t prepare your test infrastructure.
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<configuration>
<muleVersion>3.7.0</muleVersion>
<deploymentType>standalone</deploymentType>
<skip>${skipTests}</skip>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>When trying to connect to a an On Prem installation the plugin will validate certificates for that server. If you haven’t installed the server certificates in your trust store you will see an SSL error. To avoid that problem you can run the plugin in an insecure mode, this way, the security validations would be skipped. You can use the armInsecure tag or the arm.insecure system property. See the configuration example below:
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<configuration>
<deploymentType>arm</deploymentType>
<muleVersion>${mule.version}</muleVersion>
<username>${username}</username>
<password>${password}</password>
<applicationName>my-application</applicationName>
<environment>Production</environment>
<uri>https://anypoint.mulesoft.local</uri>
<armInsecure>true</armInsecure>
</configuration>
<executions>
<execution>
<id>deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>|
Warning
|
Enabling insecure connection is a very risky practice, you shouldn’t use this except when you know what you are doing and your On Prem installation is isolated in a local network. |
To configure your Anypoint Platform credentials you have two options: configure a server in your settings.xml
You can create a Maven server with username and password in your settings.xml
<servers>
<server>
<id>anypoint</id>
<username>alejandro.sequeira</username>
<password>mysuperdifficultpassword</password> <!-- This can be encrypted -->
</server>
</servers>You can configure your credentials straight in your pom.xml
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<configuration>
<username>${username}</username>
<password>${password}</password>
...
</configuration>
<executions>
...
</executions>
</plugin>In this example, username and password properties can as Maven properties in your pom.xml
<properties>
<username>alejandro.sequeira</username>
<password>mysuperdifficultpassword</password>
...
</properties>Or you can configure the credentials or overwrite them in the command line:
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent