Forge Plugin

JBoss Developer Framework plugin

Author:
Contributor: Pete Muir
Last Update: Oct 08, 2012

To simplify selecting stacks using Forge.

What is it?

This is a plugin for JBoss Forge to simplify the setup of a JBoss Stacks.

The stack is provided by Maven BOMs (Bill of Materials); read more about Maven BOMs. JBoss Developer Framework provides a BOM for every stack.

System requirements

All you need is to use this plugin is JBoss Forge 1.0.5 (or latter) and a working internet connection.

Installing the plugin

Assuming Forge is running, at the Forge prompt, type:

forge install-plugin jdf

Running the plugin

In Forge console type:

jdf use-stack --runtime

and press Tab. This will load the list of available runtimes from the JBoss Developer Framework Stacks repository (by default https://raw.github.com/jboss-jdf/jdf-stack/master/stacks.yaml). You can then select the stack to use.

Then you can also specify the bom version to use

jdf use-stack --runtime jboss-as711runtime --bom jboss-javaee-6_0-all-301

You can add multiples stacks to your project, simply run the jdf use-stack command again.

The list of available stacks is cached, and reloaded once a day. You can force a reload by running the refresh-stacks command:

jdf refresh-stacks

You can also view the available boms by running:

jdf show-boms

You can also view the available runtimes by running:

jdf show-runtimes

Custom Repository

If you want to change the default stack repository, then you will need to modify the Forge configuration.

  1. Edit ~/.forge/config.xml in your favorite editor

  2. Add the <stacksRepo> element, with the custom location, to the <jdf> element. For example:

     <configuration> 
     ...
     <jdf> 
         <stacksRepo>file:///home/benevides/stacks.yaml</stacksRepo> 
     </jdf>
     ... 
 </configuration>

  3. Run jdf refresh-stacks to force an update of the repository information

Proxy Configuration

If you access the Internet through a proxy, you must configure Forge.

Offline use

If you do not have a working internet connection, the plugin will use the cached list of available stacks.

You can force Forge to use the cached list of available stacks:

set OFFLINE true

Troubleshooting

You can turn on debugging messages:

set VERBOSE true

Share the Knowledge

Find this guide useful?

Feedback

Find a bug in the guide? Something missing? You can fix it by forking the repository, making the correction and sending a pull request. If you're just plain stuck, feel free to ask a question in the user discussion forum.

Recent Changelog

  • Oct 08, 2012: Prepare for 1.0.0.final release Rafael Benevides
  • Oct 01, 2012: Updated readme instructions Rafael Benevides
  • Jul 30, 2012: Changed jboss stacks link Rafael Benevides
  • Jul 25, 2012: Various edits to plugin docs Pete Muir
  • Jul 03, 2012: Changed the doc to use the cpi for installation Rafael Benevides
  • Jun 28, 2012: Implementation of jdf refresh stacks. the local cache is now 24 hours Rafael Benevides
  • Jun 26, 2012: Documentation updated Rafael Benevides
  • Jun 25, 2012: Addeded classes header and recommended version feature Rafael Benevides
  • Jun 20, 2012: Adjustments in markdown tags and in readme.md content Rafael Benevides
  • Jun 20, 2012: Adjustment in markdown tags Rafael Benevides
  • Jun 20, 2012: Readme spell corrections Rafael Benevides
  • Jun 20, 2012: Readme spell corrections Rafael Benevides
  • Jun 20, 2012: Readme spell corrections Rafael Benevides
  • Jun 20, 2012: Readme spell corrections Rafael Benevides
  • Jun 20, 2012: Readme spell corrections Rafael Benevides

See full history »