- Introduction
- Prerequisites
- Setup WebLogic Image Tool
- Download the required packages/installers
- Additional build files
- Additional build commands
- Steps to Create Oracle Unified Directory Services Manager image
- Generate Sample dockerfile with imagetool
This README describes the steps involved in building an Oracle Unified Directory Services Manager image with the WebLogic Image Tool.
The following prerequisites are necessary before building Oracle Unified Directory Services Manager images with Image Tool:
- A working installation of Docker 18.03 or later
- Bash version 4.0 or later (commands should be run in a
bashshell) JAVA_HOMEenvironment variable set to the location of your JDK e.g:/scratch/export/oracle/product/jdk
- Download the latest version of WebLogic Image Tool.
- Extract the release archive (zip, tar.gz) content into a desired <work directory>.
$ unzip imagetool.zip
Archive: imagetool.zip
creating: imagetool/
creating: imagetool/bin/
inflating: imagetool/bin/setup.sh
inflating: imagetool/bin/logging.properties
inflating: imagetool/bin/imagetool.cmd
inflating: imagetool/bin/imagetool.sh
inflating: imagetool/LICENSE.txt
creating: imagetool/lib/
inflating: imagetool/lib/imagetool_completion.sh
inflating: imagetool/lib/imagetool.jar
inflating: imagetool/VERSION.txt
inflating: imagetool/lib/fluent-hc-4.5.12.jar
inflating: imagetool/lib/httpclient-4.5.12.jar
inflating: imagetool/lib/httpcore-4.4.13.jar
inflating: imagetool/lib/commons-logging-1.2.jar
inflating: imagetool/lib/commons-codec-1.11.jar
inflating: imagetool/lib/httpmime-4.5.12.jar
inflating: imagetool/lib/picocli-4.3.2.jar
inflating: imagetool/lib/json-20200518.jar
inflating: imagetool/lib/compiler-0.9.6.jar
$
Run the following commands to setup imagetool
$ cd <work directory>/imagetool/bin
$ source setup.sh
Execute the following to validate the WebLogic Image Tool:
$ ./imagetool.sh --version
imagetool:1.9.3
$
The Image Tool creates a temporary Docker context directory, prefixed by wlsimgbuilder_temp, every time the tool runs. Under normal circumstances, this context directory will be deleted. However, if the process is aborted or the tool is unable to remove the directory, it is safe for you to delete it manually. By default, the Image Tool creates the Docker context directory under the user's home directory. If you prefer to use a different directory for the temporary context, set the environment variable WLSIMG_BLDDIR.
$ export WLSIMG_BLDDIR="/path/to/dir"
The Image Tool maintains a local file cache store. This store is used to look up where the Java, WebLogic Server installers, and WebLogic Server patches reside in the local file system. By default, the cache store is located in the user's $HOME/cache directory. Under this directory, the lookup information is stored in the .metadata file. All automatically downloaded patches also reside in this directory. You can change the default cache store location by setting the environment variable WLSIMG_CACHEDIR.
$ export WLSIMG_CACHEDIR="/path/to/cachedir"
Download the required installers from the Oracle Software Delivery Cloud and save them in a directory of your choice e.g: <work directory>/stage:
- Oracle Unified Directory 12.2.1.4.0
- Oracle JDK
- Oracle Fusion Middleware Infrastructure 12.2.1.4.0
Note: If the image is required to have patched included, download patches from My Oracle Support and copy to <work directory>/stage.
The Oracle Unified Directory Services Manager image requires additional files that are needed for creating and starting Oracle Unified Directory Services Manager Instance inside container. Download the required files from the docker-images repository.
For example:
$ cd <work directory>
$ git clone https://github.com/oracle/docker-images.git
This will create the required directories and files under <work directory>/docker-images.
The files required for creation of the Oracle Unified Directory Services Manager image can be located in the /docker-images/OracleUnifiedDirectorySM/dockerfiles/12.2.1.4.0/container-scripts directory:
The Oracle Unified Directory Services Manager image requires additional build commands to set the required environment variables, install os packages and copy the additional build files to the image being built.
A sample additional build commands input file can be found at <work directory>/docker-image/tree/master/OracleUnifiedDirectorySM/imagetool/12.2.1.4.0/additionalBuildCmds.txt, containing the following additional build commands:
[before-jdk-install]
# Instructions/Commands to be executed Before JDK install
[after-jdk-install]
# Instructions/Commands to be executed After JDK install
[before-fmw-install]
# Instructions/Commands to be executed Before FMW install
[after-fmw-install]
# Instructions/Commands to be executed After FMW install
[final-build-commands]
ENV BASE_DIR=/u01 \
ORACLE_HOME=/u01/oracle \
SCRIPT_DIR=/u01/oracle/container-scripts \
PROPS_DIR=/u01/oracle/properties \
VOLUME_DIR=/u01/oracle/user_projects \
DOMAIN_NAME="${DOMAIN_NAME:-base_domain}" \
ADMIN_USER="${ADMIN_USER:-}" \
ADMIN_PASS="${ADMIN_PASS:-}" \
DOMAIN_ROOT="${DOMAIN_ROOT:-/u01/oracle/user_projects/domains}" \
DOMAIN_HOME="${DOMAIN_ROOT:-/u01/oracle/user_projects/domains}"/"${DOMAIN_NAME:-base_domain}" \
ADMIN_PORT="${ADMIN_PORT:-7001}" \
ADMIN_SSL_PORT="${ADMIN_SSL_PORT:-7002}" \
DOMAIN_TYPE="oudsm" \
USER_MEM_ARGS=${USER_MEM_ARGS:-"-Djava.security.egd=file:/dev/./urandom"} \
JAVA_OPTIONS="${JAVA_OPTIONS} -Dcom.sun.jndi.ldap.object.disableEndpointIdentification=true" \
PATH=$PATH:/usr/java/default/bin:/u01/oracle/oracle_common/common/bin:/u01/oracle/wlserver/common/bin:/u01/oracle/container-scripts
USER root
RUN mkdir -p ${VOLUME_DIR} && \
chown -R oracle:oracle ${VOLUME_DIR} && chmod -R 770 ${VOLUME_DIR} && \
mkdir -p ${SCRIPT_DIR} && chown oracle:oracle ${SCRIPT_DIR} && \
mkdir -p ${PROPS_DIR} && chown oracle:oracle ${PROPS_DIR} && \
yum install -y hostname && \
rm -rf /var/cache/yum
COPY --chown=oracle:oracle files/container-scripts/ ${SCRIPT_DIR}/
RUN chmod a+xr ${SCRIPT_DIR}/* && \
chown -R oracle:oracle ${SCRIPT_DIR}
USER oracle
ENTRYPOINT ["sh", "-c", "${SCRIPT_DIR}/createDomainAndStart.sh"]
Add the required installers, packages & patches to the imagetool cache.
Navigate to the imagetool/bin directory and run the following commands. In the below examples substitute <work directory>/stage for the directory where the approriate files reside.
$ ./imagetool.sh cache addInstaller --type jdk --version 8u261 --path <work directory>/stage/jdk-8u261-linux-x64.tar.gz
For example:
$ ./imagetool.sh cache addInstaller --type jdk --version 8u261 --path /scratch/OUDDockerK8S/stage/jdk-8u261-linux-x64.tar.gz
[INFO ] Successfully added to cache. jdk_8u261=/scratch/OUDDockerK8S/stage/jdk-8u261-linux-x64.tar.gz
$
$ ./imagetool.sh cache addInstaller --type oud --version 12.2.1.4.0 --path <work directory>/stage/fmw_12.2.1.4.0_oud_generic.jar
$ ./imagetool.sh cache addInstaller --type oud --version 12.2.1.4.0 --path <work directory>/stage/fmw_12.2.1.4.0_infrastructure.jar
For example:
$ ./imagetool.sh cache addInstaller --type oud --version 12.2.1.4.0 --path /scratch/OUDDockerK8S/stage/fmw_12.2.1.4.0_oud.jar
[INFO ] Successfully added to cache. oud_12.2.1.4.0=/scratch/OUDDockerK8S/stage/fmw_12.2.1.4.0_oud.jar
$ ./imagetool.sh cache addInstaller --type fmw --version 12.2.1.4.0 --path /scratch/OUDDockerK8S/stage/fmw_12.2.1.4.0_infrastructure.jar
[INFO ] Successfully added to cache. fmw_12.2.1.4.0=/scratch/OUDDockerK8S/OUDstage/fmw_12.2.1.4.0_infrastructure.jar
In case, patches are required to be included in image, downloaded patches should be added to Imagetool cache.
$ ./imagetool.sh cache addEntry --key 28186730_13.9.4.2.4 --value <work directory>/stage/p28186730_139424_Generic.zip
$ ./imagetool.sh cache addEntry --key 31400392_12.2.1.4.0 --value <work directory>/stage/p31400392_122140_Generic.zip
$ ./imagetool.sh cache addEntry --key 31537019_12.2.1.4.0 --value <work directory>/stage/p31537019_122140_Generic.zip
$ ./imagetool.sh cache addEntry --key 31470730_12.2.1.4.0 --value <work directory>/stage/p31470730_122140_Generic.zip
$ ./imagetool.sh cache addEntry --key 31488215_12.2.1.4.0 --value <work directory>/stage/p31488215_122140_Generic.zipFor example:
$ ./imagetool.sh cache addEntry --key 28186730_13.9.4.2.4 --value /scratch/OUDDockerK8S/stage/p28186730_139424_Generic.zip
[INFO ] Added entry 28186730_13.9.4.2.4=/scratch/OUDDockerK8S/stage/p28186730_139424_Generic.zip
$ ./imagetool.sh cache addEntry --key 31400392_12.2.1.4.0 --value /scratch/OUDDockerK8S/stage/p31400392_122140_Generic.zip
[INFO ] Added entry 31400392_12.2.1.4.0=/scratch/OUDDockerK8S/stage/p31400392_122140_Generic.zip
$ ./imagetool.sh cache addEntry --key 31537019_12.2.1.4.0 --value /scratch/OUDDockerK8S/stage/p31537019_122140_Generic.zip
[INFO ] Added entry 31537019_12.2.1.4.0=/scratch/OUDDockerK8S/stage/stage/p31537019_122140_Generic.zip
$ ./imagetool.sh cache addEntry --key 31470730_12.2.1.4.0 --value /scratch/OUDDockerK8S/stage/p31470730_122140_Generic.zip
[INFO ] Added entry 31470730_12.2.1.4.0=/scratch/OUDDockerK8S/stage/stage/p31470730_122140_Generic.zip
$ ./imagetool.sh cache addEntry --key 31488215_12.2.1.4.0 --value /scratch/OUDDockerK8S/stage/p31488215_122140_Generic.zip
[INFO ] Added entry 31488215_12.2.1.4.0=/scratch/OUDDockerK8S/stage/p31488215_122140_Generic.zip
Execute the imagetool create command to create the OUD image.
The following parameters are provided as input to the create command,
- jdkVersion - JDK version to be used in the image.
- type - type of image to be built.
- version - version of the image.
- tag - tag name for the image.
- additionalBuildCommands - additional build commands provided as a text file.
- addtionalBuildFiles - path of additional build files as comma separated list.
Below a sample command used to build OUD image,
$ ./imagetool.sh create --jdkVersion=8u241 --type oud_wls --version=12.2.1.4.0 \
--tag=oracle/oudsm:12.2.1.4.0 \
--additionalBuildCommands <work directory>/docker-image/OracleUnifiedDirectory/dockerfiles/12.2.1.4.0/imagetool/12.2.1.4.0/buildCmds.txt \
--additionalBuildFiles <work directory>/docker-image/OracleUnifiedDirectory/dockerfiles/12.2.1.4.0/container-scripts \
--patches <patch_a>,<patch_b>,...
--patches option is required only when image is required to be generated with patches
For example:
$ ./imagetool.sh create --jdkVersion=8u261 --type oud_wls --version=12.2.1.4.0 \
--tag=oracle/oudsm:12.2.1.4.0 \
--additionalBuildCommands /scratch/OUDDockerK8S/docker-image/OracleUnifiedDirectorySM/imagetool/12.2.1.4.0/additionalBuildCmds.txt \
--additionalBuildFiles /scratch/OUDDockerK8S/docker-image/OracleUnifiedDirectorySM/dockerfiles/12.2.1.4.0/container-scripts \
--patches 28186730,31400392,31537019,31470730,31488215
--patches option is required only when image is required to be generated with patches
Run the docker images command to ensure the new OAM image is loaded into the repository:
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
oracle/oudsm 12.2.1.4.0 7157885054a2 10 minutes ago 2.74GB
...
If you want to review a sample dockerfile created with the imagetool issue the imagetool command with the --dryRun option:
./imagetool.sh @<work directory/build/buildArgs --dryRun
To download and run Oracle Fusion Middleware products, regardless whether inside or outside a Docker container, you must download the binaries from the Oracle website and accept the license indicated at that page.
All scripts and files hosted in this project and GitHub docker-images/OracleUnifiedDirectory repository required to build the images are, unless otherwise noted, released under UPL 1.0 license.
Copyright (c) 2020 Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl