Handy Environment for Java Applications - S2I Builder Image

Source-To-Image (S2I) is a standalone toolkit and workflow for creating builder images. It allows you to build reproducible Docker images from source code and it's the major strategy used for building applications in OpenShift 3. This repository contains the source code for building Java applications with various JDK versions as a reproducible image using source-to-image. The image to be built expects a regular executable jar file that comes from a repository as input. The input can be a maven or gradle project.

To Build Image

oc new-build https://github.com/hakdogan/handy-environment \ 
--name jdk-container

Available Environment Variables

You can use some environment variable with this builder for your needs.

JDK Variable

You can use the jdk environment variable for JDK version you want. For example, if you want to use Open JDK 7, you should be used following command.

oc new-build https://github.com/hakdogan/handy-environment \ 
--env jdk=openjdk7 --name jdk-container

When you don't use jdk variable or use a different value than following, Oracle JDK 8 is installed by default.

ENV	MEANING
--env jdk=openjdk6	6 version of OpenJDK will be installed
--env jdk=openjdk7	7 version of OpenJDK will be installed
--env jdk=openjdk8	8 version of OpenJDK will be installed
--env jdk=openjdk9	9 version of OpenJDK will be installed
--env jdk=openjdk10	10 version of OpenJDK will be installed
--env jdk=openjdk11	11 version of OpenJDK will be installed
--env jdk=oraclejdk6	6 version of Oracle JDK will be installed
--env jdk=oraclejdk7	7 version of Oracle JDK will be installed
--env jdk=oraclejdk8	8 version of Oracle JDK will be installed

SFPATH Variable

When you have multiple jar or your jar is not in the default build directory you can specify the full path of the jar. In addition, you can define arguments to passing the jar or custom exec command to be executed. For all of these, you must provide the setting.yml file in your input project and pass the full path of that file to the sfpath variable. For example:

oc new-build https://github.com/hakdogan/handy-environment.git \ 
--name jdk-container \
--env sfpath="SharedDataProvider/src/main/resources"

The setting.yml

project:
  buildFileDirectory: path/
  jarName: path/name.jar
  arguments: -cluster #for multiple arguments ["-cp\ 'classes:lib/myjar.jar'",  "-instances\ 10"]
  outputDirectory: path/
  execCommand: mvn exec:exec
  execCommandWorkDir: path/
  

To Deployment

oc new-app jdk-container~$repo_url_or_path