1.5. Fuse Builder Cartridge
Overview
The Fuse Builder cartridge builds the Maven repository of a JBoss A-MQ application, and rebuilds the repository each time you update any of the repository artifacts.
This cartridge provides an HTTP connection to the repository that you can use to connect to the repository from all nodes that run JBoss A-MQ applications.
When you deploy JBoss A-MQ applications in a high availability configuration, you can specify this cartridge as the remote Maven repository to ensure that the master and slave nodes can always access the Maven artifacts.
Installing the cartridge
The Fuse Builder cartridge is shipped as an RPM package. You install the cartridge in the same way that you install the JBoss A-MQ cartridge.
When you install this cartridge, note the following guidelines:
- You must deploy at least one JBoss A-MQ cartridge in the OpenShift Enterprise domain before you install and deploy this cartridge.
- You must install this cartridge on every node in the OpenShift Enterprise domain.
- You can install this cartridge with any gear profile.
Configuring security
Before you begin to use the Fuse Builder cartridge, you must specify which users can download the artifacts from the Maven repository.
- Clone the cartridge Git repository to your development machine.
- In the
.openshift/configdirectory of the cloned repository, open thehttpd.conffile and uncomment the security section. - Run the following command to create a password file in the
.openshift/configdirectory:htpasswd -cb passwords <USERNAME> <PASSWORD>
- Commit and push the new password file and the edited
httpd.conffile to the remote repository.
Adding the Maven repository to the JBoss A-MQ application
In each JBoss A-MQ application that you want to connect with the Maven repository, add the repository address to the default profile.
If you use the Fuse Management Console, you access the default profile with the following path:
/hawtio/index.html#/wiki/branch/<version_number>/view/fabric/profiles/default.profile/io.fabric8.agent.properties
You add the repository URL to the list of Maven repositories in the
org.ops4j.pax.url.mvn.repositories property.
The URL pattern must be in one of the following formats:
http://${app-dns}/repohttps://${user}:${password}@${app-dns}
Note
For more information on how to edit the Fabric8 profile, see Fabric Guide
Deploying the cartridge in a high availability environment
When you deploy this cartridge in an application cluster, note the following guildelines:
- The Fuse Builder cartridge supports auto-scaling. When you deploy this cartridge in an application cluster, specify auto-scaling to a minimum of 3 gears.
- In case of node failure, you must manually change the Jolokia URL in the
\fuse-builder\etc\settings.xmlfile to connect to the active node. You specify the URL in the following property:<fabric8.jolokiaUrl>http://[host_name]:8181/jolokia</fabric8.jolokiaUrl>
