Java

OKD provides an S2I builder image for building Java applications. This builder image takes your application source or binary artifacts, builds the source using Maven (if source was provided), and assembles the artifacts with any required dependencies to create a new, ready-to-run image containing your Java application. This resulting image can be run on OKD or run directly with Docker.

The builder image is intended for use with Maven-based Java standalone projects that are run via main class.

The current version of the Java S2I builder image supports OpenJDK 1.8, Jolokia 1.3.5, and Maven 3.3.9-2.8.

The RHeL 7 image is available through the Red Hat Registry:

To use this image on OKD, you can either access it directly from the Red Hat Registry or push it into your OKD Docker registry. Additionally, you can create an image stream that points to the image, either in your Docker registry or at the external location. Your OKD resources can then reference the image stream definition.

S2I produces ready-to-run images by injecting source code into a container and letting the container prepare that source code for execution. It performs the following steps:

See S2I Build Process for a detailed overview of the build process.

By default, the Java S2I builder image uses Maven to build the project with the following goals and options:

Based on these defaults, the builder image compiles the project and copies all the transitive dependencies into the output directory without running tests. Additionally, if the project has a profile named openshift, then it is activated for the build.

You can override these default goals and options by specifying the following environment variables:

The same S2I builder image can be used to build a Java application from source or from binary artifacts.

The Java S2I builder image can be used to build an application from source by running oc new-app against a source repository:

By default, tests are not run. To build an application and run tests as part of the build, override the default MAVeN_ARGS, as in the following command:

If a Java project consists of multiple Maven modules, it can be useful to explicitly specify the artifact output directory. Specifying the directory where the Maven project outputs the artifacts enables the S2I build to pick them up.

To specify the modules to build and the artifact output directory, use the following command:

The Java S2I builder image can be used to build an application using binary artifacts that you provide. To do so, first create a new binary build using the oc new-build command:

Next, start a build using the oc start-build command, specifying the path to the binary artifacts on your local machine:

Finally, use the oc new-app command to create an application: