...
- You can create a plugin as part of a maven build by using the car-maven-plugin.
- You can create a plugin "virtually" by installing a deployed application from a running Geronimo server acting as a plugin repository.
- You can create a plugin by using the Geronimo administration console to create or edit the plugin metadata.
By far the easiest way to build a Geronimo plugin is with maven using the car-maven-plugin. Any such module will include includes a geronimo-plugin.xml descriptor with at least minimal information. When possible, this information, such as the description and license imformation, this information is taken from the pom file itself. Normally, you will build the dependency list from the modules dependencies which that are constructed from the maven dependencies plus whatever additional dependencies the deployers deployer determine that are needed. For instance, an ejb application will have the openejb plugin added as a dependency by the openejb deployer. If necessary, you can specify the dependencies for both the module and plugin descriptor explicitly in the car-maven-plugin configuration.
...
As you use maven to build plugins, a geronimo-plugins.xml plugin catalog is automatically maintained in your local maven repository. You can force this to be rebuilt by running the following command:
| Code Block |
|---|
mvn org.apache.geronimo.buildsupport:car-maven-plugin:create-pluginlist |
...
The administration console also allows limited editing of the geronimo-plugin.xml files, but editing the information about how the plugin fits into the server is not yet supported.
...
If the appropriate administration console plugin is installed (and your Geronimo server includes Web application support), you can install plugins from a plugin repository. After selecting the Plugins page from the navigation menu, select the plugin repository that you want, such as your local maven repository if you have been building your own plugins. Next, you will see a list of available plugins from the repository. Select multiple plugins using the checkboxes check boxes or a single plugin as a link, and on the next page you will see more information on about the plugins. On your approval the plugins will be downloaded and installed.
...