vertx-maven-plugin icon indicating copy to clipboard operation
vertx-maven-plugin copied to clipboard

Vert.x Maven Plugin - moved to https://github.com/reactiverse/vertx-maven-plugin

= Maven Plugin for Eclipse Vert.x

The project has been migrated to: https://github.com/reactiverse/vertx-maven-plugin and https://reactiverse.io/vertx-maven-plugin/ for the documentation

This repository should not be used anymore.

//[cols="2,2"] //|=== //|Circle CI (Linux / OS X)| AppVeyor (Windows) //|image:https://circleci.com/gh/reactiverse/vertx-maven-plugin.svg?style=shield["CircleCI", link="https://circleci.com/gh/reactiverse/vertx-maven-plugin"] //|image:https://ci.appveyor.com/api/projects/status/w68t5uccpfuy4176?svg=true["AppVeyor", link="https://ci.appveyor.com/project/kameshsampath/vertx-maven-plugin"] //|===

This Maven plugin is a one-stop-shop for packaging, running, starting and stopping http://vertx.io[vert.x] Java applications. This plugin combines the goals of Maven Shade, Maven Exec into one, allowing the users to have a simplified pom.xml.

== Features

The following are the list of features that will be part of the plugin:

  • [*] https://reactiverse.github.io/vertx-maven-plugin/#vertx:package[Packaging] the vert.x application as fat or uber jar
  • [*] https://reactiverse.github.io/vertx-maven-plugin/#vertx:run[Running] vert.x application as part of maven build in forked or unforked mode
  • [*] https://reactiverse.github.io/vertx-maven-plugin/#vertx:start[Starting] vert.x application a daemon mode by tagging with a autogenerated id or configurable id i.e. -id option to vertx start
  • [*] https://reactiverse.github.io/vertx-maven-plugin/#vertx:setup[Setup] Set up your existing or new maven project with vert.x maven plugin and vert.x core dependencies
  • [*] https://reactiverse.github.io/vertx-maven-plugin/#vertx:stop[Stopping] vert.x application running daemon mode, this also allows to pass multiple application id's to be stopped
  • [*] Ability to pass vertx configuration -conf automatically if a file named artifactId.json or artifactId.yaml or or artifactId.yml is present in project sources under src/main/conf. The users can also configure the same via plugin configuration. Refer to https://reactiverse.github.io/vertx-maven-plugin/#vertx:run[vertx:run] for more information
  • [*] Ability to perform when redeploy is enabled, please check the https://reactiverse.github.io/vertx-maven-plugin/#vertx:run[vertx:run] for more information
  • [*] Ability to perform SPI combining when serviceProviderCombination is configured https://reactiverse.github.io/vertx-maven-plugin/#vertx:package[vertx:package] for more information

=== Plugin Goals [cols="1,3"] |=== |Goal | Description | https://reactiverse.github.io/vertx-maven-plugin/#vertx:package[vertx-maven-plugin:package] | Package http://vertx.io[vert.x] application into a fat jar | https://reactiverse.github.io/vertx-maven-plugin/#vertx:run[vertx-maven-plugin:run] | Runs the http://vertx.io[vert.x] application from the maven build | https://reactiverse.github.io/vertx-maven-plugin/#vertx:start[vertx-maven-plugin:start] | Will start the http://vertx.io[vert.x] application as daemon | https://reactiverse.github.io/vertx-maven-plugin/#vertx:setup[vertx-maven-plugin:setup] | Set up your existing or new maven project with vert.x maven plugin and vert.x core dependencies | https://reactiverse.github.io/vertx-maven-plugin/#vertx:stop[vertx-maven-plugin:stop] | Will stop the http://vertx.io[vert.x] application running as daemon |===

== Documentation

  • https://reactiverse.github.io/vertx-maven-plugin/[Plugin Documentation]

== Issues

If you feel to add any feature you can open issue in https://github.com/reactiverse/vertx-maven-plugin/issues and we will try to address it as soon as possible

== Contributing

We love contributions, if you wish to contribute a patch or feature, please open a issue in https://github.com/reactiverse/vertx-maven-plugin/issues and send in a PR.