Red Hat Training

A Red Hat training course is available for Red Hat Fuse

1.5. Fuse Builder Cartridge

Overview

The Fuse Builder cartridge builds the Maven repository of a JBoss Fuse 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 Fuse applications.
When you deploy JBoss Fuse 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 Fuse cartridge.
When you install this cartridge, note the following guidelines:
  • You must deploy at least one JBoss Fuse 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.
  1. Clone the cartridge Git repository to your development machine.
  2. In the .openshift/config directory of the cloned repository, open the httpd.conf file and uncomment the security section.
  3. Run the following command to create a password file in the .openshift/config directory: 
    htpasswd -cb passwords <USERNAME> <PASSWORD>
  4. Commit and push the new password file and the edited httpd.conf file to the remote repository.

Adding the Maven repository to the JBoss Fuse application

In each JBoss Fuse 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}/repo
  • https://${user}:${password}@${app-dns}

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.xml file to connect to the active node. You specify the URL in the following property: