Sample Docker configurations to facilitate installation, configuration, and environment setup for DevOps users. This project includes quick start dockerfiles and samples for WebLogic 12.1.3, 12.2.1, 12.2.1.1, 12.2.1.2, and 12.2.1.3 based on Oracle Linux and Oracle JDK 8 (Server).
The certification of WebLogic 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.
For more information on the certification, please check the WebLogic on Docker Certification Whitepaper and WebLogic Blog for updates.
For pre-built images containing Oracle software, please check the Oracle Container Registry.
This project offers sample Dockerfiles for WebLogic 12cR2 (12.2.1.x) and WebLogic 12c (12.1.3), and for each version it also provides at least one Dockerfile for the 'developer' distribution, a second Dockerfile for the 'generic' distribution. To assist in building the images, you can use the buildDockerImage.sh script. See below for instructions and usage.
The buildDockerImage.sh script is just a utility shell script that performs MD5 checks and is an easy way for beginners to get started. Expert users are welcome to directly call docker build with their prefered set of parameters.
You must first download the Oracle Server JRE binary and drop in folder ../OracleJava/java-8 and build that image. For more information, visit the OracleJava folder's README file.
$ cd ../OracleJava/java-8
$ sh build.sh
IMPORTANT: you have to download the binary of WebLogic and put it in place (see .download files inside dockerfiles/).
Before you build, choose which version and distribution you want to build an image of, then download the required packages (see .download files) and drop them in the folder of your distribution version of choice. Then go into the dockerfiles folder and run the buildDockerImage.sh script as root.
$ sh buildDockerImage.sh -h
Usage: buildDockerImage.sh -v [version] [-d | -g | -i] [-s]
Builds a Docker Image for Oracle WebLogic.
Parameters:
-v: version to build. Required.
Choose one of: 12.1.3 12.2.1, 12.2.1.1, 12.2.1.2, 12.2.1.3
-d: creates image based on 'developer' distribution
-g: creates image based on 'generic' distribution
-i: creates image based on 'infrastructure' distribution
-c: enables Docker image layer cache during build
-s: skips the MD5 check of packages
* select one distribution only: -d, -g, or -i
LICENSE UPL 1.0
Copyright (c) 2014-2017 Oracle and/or its affiliates. All rights reserved.
IMPORTANT: the resulting images will NOT have a domain pre-configured. You must extend the image with your own Dockerfile, and create your domain using WLST. You might take a look at the use case samples as well below.
To give users an idea on how to create a domain from a custom Dockerfile to extend the WebLogic image, we provide a few samples for 12c versions for the Developer distribution. There are two kind of domain samples
- The domain home is built inside a Docker image. For an example on 12.2.1, you can use the sample inside samples/1221-domain folder.
- The domain home is mapped into a host volume. For the 12.2.1.3 version, check the folder samples/12213-domain.
WebLogic has a Machine concept, which is an operational system with an agent, the Node Manager. This resource allows WebLogic AdminServer to create and assign Managed Servers of an underlying domain in order to expand an environment of servers for different applications and resources, and also to define a Cluster. With some WLST magic, your cluster can scale in and out.
You can deploy a cluster of WebLogic using Docker with the samples scripts defined in the folder samples/12213-domain. After you have an AdminServer running o container, you can easily create a cluster by deploying new Docker containers of Managed Servers.
To start the containerized Admin Server, run
$ docker run -d --name wlsadmin --hostname wlsadmin -p 7001:7001 --env-file ./container-scripts/domain.properties -e ADMIN_PASSWORD=<admin_password> -v <host directory>:/u01/oracle/user_projects 12213-domain
To start a containerized Managed Server (MS1) to self-register with the Admin Server above, run:
$ docker run -d --name MS1 --link wlsadmin:wlsadmin -p 8001:8001 --env-file ./container-scripts/domain.properties -e ADMIN_PASSWORD=<admin_password> -e MS_NAME=MS1 --volumes-from wlsadmin 12213-domain createServer.sh
To start a second Managed Server (MS2), run the following command:
$ docker run -d --name MS2 --link wlsadmin:wlsadmin -p 8002:8001 --env-file ./container-scripts/domain.properties -e ADMIN_PASSWORD=<admin_password> -e MS_NAME=MS2 --volumes-from wlsadmin 12213-domain createServer.sh
The above scenario from this sample will give you a WebLogic domain with a cluster setup, on a single host environment.
By using the sample samples/1221-multihost, which contains a set of scripts that leverage Docker Machine and Docker Swarm, and by digging through the scripts that create the containers across multiple hosts combined with the scripts inside 1221-domain/container-scripts, you can learn the necessary steps to deploy this with different Docker setups.
The basic idea behind this setup is that you must have all the containers across different hosts assigned to a specific Docker Overlay Network, a feature of Docker 1.9+ that allows containers to join the same network, even though they are running at different host environments.
The Supplemental Quick Installer is a lightweight installer that contains all of the necessary artifacts to develop and test applications on Oracle WebLogic Server 12.2.1.3. You can extend the WebLogic developer install image oracle/weblogic:12.2.1.3-developer to create a domain image with the MedRec application deployed.
-
Make sure you have
oracle/weblogic:12.2.1.3-developerimage built. If not go into dockerfiles and call$ sh buildDockerImage.sh -v 12.2.1.3 -d
-
Go to folder samples/1221-medrec
-
Download into this folder the supplemental package for WebLogic 12R2
-
Edit Dockerfile to extend thye 12.2.1.3 image
-
Run the following command:
$ docker build -t 12213-medrec .
-
Now run a container from this new sample domain image
$ docker run -ti -p 7002:7002 12213-medrec
-
Now access the AdminServer Console at
This project hosts two configurations (depending on WebLogic version) for building Docker images with WebLogic 12c.
-
Quick Install Developer Distribution
- For more information on the WebLogic 12cR2 Quick Install Developer Distribution, visit WLS Quick Install Distribution for Oracle WebLogic Server 12.2.1.3.
-
Generic Distribution
- For more information on the WebLogic 12cR2 Generic Full Distribution, visit WebLogic 12.2.1.3 Documentation
To download and run WebLogic 12c Distribution regardless of inside or outside a Docker container, and regardless of the distribution, you must download the binaries from Oracle website and accept the license indicated at that page.
To download and run Oracle JDK regardless of inside or outside a Docker container, you must download the binary from Oracle website and accept the license indicated at that page.
All scripts and files hosted in this project and GitHub docker/OracleWebLogic repository required to build the Docker images are, unless otherwise noted, released under UPL 1.0 license.
Copyright (c) 2014-2017 Oracle and/or its affiliates. All rights reserved.