PreImage Kit for Quantum Fabric Containers

The PreImage kit contains Docker artifacts that can be used to generate Docker images for Quantum Fabric. The images can be generated on the latest operating systems and contain the latest fixes for any vulnerabilities. You can generate the Docker images with default versions or custom versions of the base image and Tomcat. To generate the Docker images, you must use the build-images.sh script that is included in the PreImageKit.zip file.

Folder (Zip) Structure

The structure of the PreImageKit.zip file (or the extracted folder) is as follows:

  • preImageKit
    • fabric: This folder contains artifacts to build images for Fabric components.
    • flyway: This folder contains artifacts to build database images.
    • Dockerfile_Console
    • Dockerfile_Identity
    • Dockerfile_Middleware
    • Dockerfile_Engagement
    • Dockerfile_Apiportal
    • Dockerfile_FabricAll
    • Dockerfile_Flyway
    • build-images.sh
    • version.txt

Generate Docker Images

You can generate the Docker images with default versions or custom versions of the base image and Tomcat. For more information, refer to either of the following section.

NOTE: If you use this method, the script generates the images with default values for the base image and Tomcat.

  1. In the PreImage Kit folder, open the terminal console.
  2. Build the Docker images by using the following command:
    ./build-images.sh

The script generates the Docker images and tags them with the Fabric version that is specified in the version.txt file.

NOTE: If you use this method, the script generates the images with a specific version of the base image and Tomcat. You can provide these values as run-time arguments.

  1. In the PreImage Kit folder, open the terminal console.
  2. Build the Docker images by using the following command:
    ./build-images.sh -t <TOMCAT_VERSION> -o <BASE_IMAGE>

Ensure that you replace <TOMCAT_VERSION>, and <BASE_IMAGE> with the version number that you want to use. For example:

./build-images.sh -t 9.0.63 -o redhat/ubi8-minimal:latest

The script generates the Docker images.

To publish to a private repository, tag the images with the repository name and push them to the repository. If Helm charts are utilized, specify the repository name and registry name in the charts. Create a secret containing the registry credentials and update the secret name within the charts under the "pullsecret" key.

Update the Config File

After building the images, ensure that you update the image version in the config.properties file. In the following example, the images are tagged with the 9.7.1.4_GA version.

  • FABRIC_DATABASE_IMAGE_TAG=kony-fabric-db:9.7.1.4_GA
  • CONSOLE_IMAGE_TAG=kony-fabric-console:9.7.1.4_GA
  • APIPORTAL_IMAGE_TAG=kony-fabric-apiportal:9.7.1.4_GA
  • ENAGAGEMENT_IMAGE_TAG=kony-fabric-engagement:9.7.1.4_GA
  • INTEGRATION_IMAGE_TAG=kony-fabric-integration:9.7.1.4_GA
  • IDENTITY_IMAGE_TAG=kony-fabric-identity:9.7.1.4_GA

NOTE: If the images are tagged with a user name then you must provide the user name in the tag.

For example, if your user name is konyfabric provide the tag as follows:
FABRIC_DATABASE_IMAGE_TAG=konyfabric/kony-fabric-db:9.7.1.4_GA

After generating the Docker images and updating the image tags in the config.properties file, you can install and deploy Quantum Fabric.