README.md

Oracle Coherence Docker Image

This section is about using Oracle Coherence in Docker. The purpose of the Docker images described here is to facilitate the setup of development and integration testing environments for developers. This project includes example dockerfiles and documentation for Coherence 12.2.1 based on Oracle Linux and Oracle JDK 8.

The certification of Coherence on Docker does not require the use of any file presented in this repository. Customers and users are welcome to use them as starters, and customize/tweak, or create from scratch new scripts and Dockerfiles.

Standalone Distribution

Building Oracle JDK (Server JRE) base image

Before you can build these Oracle Coherence images you must have built the required Oracle Java 8 base image (see Oracle Java images)

How to Build

Follow this procedure:

Checkout the GitHub Oracle Docker Images repository

$ git clone git@github.com:oracle/docker-images.git

Go to the OracleCoherence/dockerfiles/12.2.1 folder

$ cd OracleCoherence/dockerfiles/12.2.1

Download and drop the Coherence distribution file of your choice into this folder. The build script supports either building an image from either the Standalone Installer, fmw_12.2.1.0.0_coherence_Disk1_1of1.zip or the Quick Installer fmw_12.2.1.0.0_coherence_quick_Disk1_1of1.zip

Execute the build script buildDockerImage.sh.

$ sh buildDockerImage.sh

or if your Docker client requires commands to be run as root you can run

$ sudo sh buildDockerImage.sh

The script will determine which installer and image it is building from the installer file that is in the working directory. If both the Standalone and Quick installers are present then the default will be to use the Standalone installer. You can specify which installer to use with a script argument. To run the Standalone installer use:

$ sh buildDockerImage.sh -s

Or to run the Quick installer use:

$ sh buildDockerImage.sh -q

If you are using a later version of Coherence than 12.2.1.0.0 then you can use the -v parameter to specify a version. For example if you are using 12.2.1.1.0 you would run:

$ sh buildDockerImage.sh -v 12.2.1.1.0

The resulting image file will be called oracle/coherence:${version}-${distribution}, for example if the Standalone installer is used the image will be oracle/coherence:12.2.1.0.0-standalone

The image is built with a shell script as its ENTRYPOINT that allows the image to be run using the normal Docker run command. See the Image Usage documentation.

Documentation

Documentation covering the different aspects of running Oracle Coherence in Docker containers is covered in the docs section.

All scripts and files hosted in this project on GitHub docker-images/OracleCoherence repository required to build the Docker images are, unless otherwise noted, released under UPL 1.0, except for the files listed above with their specific licenses.