7.2. Using the Plug-In to Deploy a Maven Project
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 7.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
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:
Adding the plug-in to a Maven POM
If you add the Fabric8 plug-in to your
pom.xmlfile as follows:
<plugins> <plugin> <groupId>io.fabric8</groupId> <artifactId>fabric8-maven-plugin</artifactId> <version>1.2.0.redhat-621084</version> <configuration> <profile>testprofile</profile> <version>1.2</version> </configuration> </plugin> </plugins>
plugin/configuration/versionelement specifies the Fabric8 version of the target system (which is not necessarily the same as the version of the Fabric8 Maven plug-in).
You can now use the following more concise Maven goal:
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.
You can try out the plug-in with one of the JBoss Fuse
quickstartexamples, 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).