Instructions/Quick Start

Prerequisites
------------

Image sources have been provided to allow custom building of Red Hat Process
Automation Manager and Red Hat Decision Manager images. Prior to 7.2.0, there
were two forms of RHDM and RHPAM images, standalone and OpenShift. The standalone
images are no longer required to be built separately, instead they are pulled in
as modules to the OpenShift image build.

You are still required to compile the base images outlined below first. Sources
for these images can be found at:

https://github.com/jboss-container-images/

Some base images and their associated repositories that may be of interest:

* jboss/openjdk18-rhel7 | https://github.com/jboss-container-images/jboss-openjdk-image
* jboss-eap-7/eap71     | https://github.com/jboss-container-images/jboss-eap-7-image
* jboss/base-rhel7^     | https://github.com/jboss-container-images/jboss-base-image

When building these images, you must build the release branch which is typically named
without any suffix (dev, cp). For example, base-rhel7 instead of base-rhel7-dev.

The JBoss base image depends on the RHEL 7 base image, this is available via the
Red Hat Container Catalog. To consume the image, the source must be altered to
reference the latest image available in the stream instead of "released".

Building Images
---------------

In order to build these images, you must use the cekit tool (previously known as
concreate) in combination with the sources provided under "src". Instructions
for installing the tool can be found here:

http://cekit.readthedocs.io/en/latest/installation.html

The images require the RHEL and RHSCL repositories, a sample configuration file
has been provided (cekit-config).

For more information on setting up a mirror of the RHEL and RHSCL repositories
see the following article:

https://access.redhat.com/solutions/23016

In addition to the RHEL and RHSCL repository definitions, this file also defines
the location of the binaries required by the images to build, point this to an
absolute path to the binaries, leaving the #filename# reference, for example:

cache_url = file:///tmp/binaries/#filename#

Within the sub-folders for the RHDM and RHPAM images, there are several override
files. The dev-overrides will typically point to more recent sources and could be
unstable. The prod-overrides will point to stable sources for a known product
release. Be sure to add your intended overrides file to the command below, an
example is provided utilising dev-overrides.yaml.

Once you have updated the Cekit configuration file run this from any
directory containing the image.yaml:

cekit build --build-engine=docker --config /path/to/cekit-config --overrides-file dev-overrides.yaml

For a full list of options to cekit, consult the documentation above.
