5.2. Using the Plug-In to Deploy a Maven Project
Prerequisites
You must ensure the following prerequisites are satisfied before attempting to run the Fabric8 Maven plug-in:
- Your Maven
~/.m2/settings.xmlfile is configured as described in Section 5.1, “Preparing to Use the Plug-In”. - A JBoss Fuse container instance is running on your local machine (alternatively, if the container instance is running on a remote host, you must configure the plug-in's
jolokiaUrlproperty appropriately).
Running the plug-in on any Maven project
To use the Fabric8 plug-in to deploy any maven project into a fabric profile, enter the following Maven command:
mvn io.fabric8:fabric8-maven-plugin:1.0.0.redhat-355:deploy
Adding the plug-in to a Maven POM
If you add the Fabric8 plug-in to your
pom.xml file as follows:
<plugins>
<plugin>
<groupId>io.fabric8</groupId>
<artifactId>fabric8-maven-plugin</artifactId>
</plugin>
</plugins>
You can use the following more concise Maven goal:
mvn fabric8:deploy
What does the plug-in do?
When you deploy your project to a Fabric profile with this plug-in, the plug-in does the following:
- Uploads any artifacts into the fabric's Maven repository,
- Lazily creates the Fabric profile or version you specify,
- Adds/updates the Maven project artifact into the profile configuration,
- Adds any additional parent profile, bundles or features to the profile.
Example
You can try out the plug-in with one of the JBoss Fuse
quickstart examples, as follows:
cd InstallDir/quickstarts/rest mvn io.fabric8:fabric8-maven-plugin:1.0.0.redhat-355:deploy
You should see a new profile created at the my-rest/rest profile page, which should have a bundle and some features (click on the Bundle tab and the Feature tab).
