Create or update an image

If you have access to the My Oracle Support (MOS), and there is a need to build a new image with a patch (bundle or interim), it is recommended to use the WebLogic Image Tool to build an Oracle SOA Suite image for production deployments.

• Create or update an Oracle SOA Suite Docker image using the WebLogic Image Tool
  • Set up the WebLogic Image Tool
  • Create an image
  • Update an image
• Create an Oracle SOA Suite Docker image using Dockerfile

Create or update an Oracle SOA Suite Docker image using the WebLogic Image Tool

Using the WebLogic Image Tool, you can create a new Oracle SOA Suite Docker image (can include patches as well) or update an existing image with one or more patches (bundle patch and interim patches).

Recommendations:

• Use create for creating a new Oracle SOA Suite Docker image either:
  • without any patches
  • or, containing the Oracle SOA Suite binaries, bundle patch and interim patches. This is the recommended approach if you have access to the Oracle SOA Suite patches because it optimizes the size of the image.
• Use update for patching an existing Oracle SOA Suite Docker image with a single interim patch. Note that the patched image size may increase considerably due to additional image layers introduced by the patch application tool.

Set up the WebLogic Image Tool

• Prerequisites
• Set up the WebLogic Image Tool
• Validate setup
• WebLogic Image Tool build directory
• WebLogic Image Tool cache
• Set up additional build scripts

Prerequisites

Verify that your environment meets the following prerequisites:

• Docker client and daemon on the build machine, with minimum Docker version 18.03.1.ce.
• Bash version 4.0 or later, to enable the command complete feature.
• JAVA_HOME environment variable set to the appropriate JDK location.

Set up the WebLogic Image Tool

To set up the WebLogic Image Tool:

1. Create a working directory and change to it. In these steps, this directory is imagetool-setup.

   $ mkdir imagetool-setup
   $ cd imagetool-setup
   

2. Download the latest version of the WebLogic Image Tool from the releases page.

3. Unzip the release ZIP file to the imagetool-setup directory.

4. Execute the following commands to set up the WebLogic Image Tool on a Linux environment:

   $ cd imagetool-setup/imagetool/bin
   $ source setup.sh
   

Validate setup

To validate the setup of the WebLogic Image Tool:

1. Enter the following command to retrieve the version of the WebLogic Image Tool:

   $ imagetool --version
   

2. Enter imagetool then press the Tab key to display the available imagetool commands:

   $ imagetool <TAB>
   cache   create  help    rebase  update
   

WebLogic Image Tool build directory

The WebLogic 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 WebLogic 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/buid/dir"

WebLogic Image Tool cache

The WebLogic 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"

Set up additional build scripts

Creating an Oracle SOA Suite Docker image using the WebLogic Image Tool requires additional container scripts for Oracle SOA Suite domains.

1. Clone the docker-images repository to set up those scripts. In these steps, this directory is DOCKER_REPO:

   $ cd imagetool-setup
   $ git clone https://github.com/oracle/docker-images.git
   

2. Copy the additional WebLogic Image Tool build files from the operator source repository to the imagetool-setup location:

   $ mkdir -p imagetool-setup/docker-images/OracleSOASuite/imagetool/12.2.1.4.0
   $ cd imagetool-setup/docker-images/OracleSOASuite/imagetool/12.2.1.4.0
   $ cp -rf ${WORKDIR}/imagetool-scripts/* .
   

Note: If you want to create the image continue with the following steps, otherwise to update the image see update an image.

Create an image

After setting up the WebLogic Image Tool and required build scripts, follow these steps to use the WebLogic Image Tool to create a new Oracle SOA Suite Docker image.

Download the Oracle SOA Suite installation binaries and patches

You must download the required Oracle SOA Suite installation binaries and patches as listed below from the Oracle Software Delivery Cloud and save them in a directory of your choice. In these steps, this directory is download location.

The installation binaries and patches required for release 23.1.2 are:

• JDK:

  • jdk-8u361-linux-x64.tar.gz

• Fusion Middleware Infrastructure installer:

  • fmw_12.2.1.4.0_infrastructure.jar

• Oracle SOA Suite installers:

  • fmw_12.2.1.4.0_soa.jar
  • fmw_12.2.1.4.0_osb.jar
  • fmw_12.2.1.4.0_b2bhealthcare.jar

• Fusion Middleware Infrastructure patches:

  • p28186730_1394211_Generic.zip (OPATCH OPATCH 13.9.4.2.11 FOR EM 13.4, 13.5 AND FMW/WLS 12.2.1.3.0, 12.2.1.4.0 AND 14.1.1.0.0)
  • p34883826_122140_Generic.zip (WLS PATCH SET UPDATE 12.2.1.4.221210)
  • p34879707_122140_Generic.zip (FMW Thirdparty Bundle Patch 12.2.1.4.221209)
  • p33950717_122140_Generic.zip (OPSS Bundle Patch 12.2.1.4.220311)
  • p34839859_122140_Generic.zip (OWSM BUNDLE PATCH 12.2.1.4.221128)
  • p34944256_122140_Generic.zip (ADF BUNDLE PATCH 12.2.1.4.230103)
  • p34845927_122140_Generic.zip (Coherence 12.2.1.4 Cumulative Patch 16 (12.2.1.4.16))
  • p33093748_122140_Generic.zip (FMW PLATFORM 12.2.1.4.0 SPU FOR APRCPU2021)
  • p33639718_122140_Linux-x86-64.zip (ADR FOR WEBLOGIC SERVER 12.2.1.4.0 JULY CPU 2022)
  • p32720458_122140_Generic.zip (JDBC One Off)
  • p34801809_122140_Generic.zip (RDA release 23.1-20230117 for FMW 12.2.1.4.0)
  • p34065178_122140_Generic.zip (OVD One Off)
  • p34542329_122140_Generic.zip (EM One Off)
  • p34765492_122140_Generic.zip (EM One Off)

• Oracle SOA Suite and Oracle Service Bus patches

  • p34824004_122140_Generic.zip (SOA Bundle Patch 12.2.1.4.221122)
  • p32121987_122140_Generic.zip (Oracle Service Bus BUNDLE PATCH 12.2.1.4.201105)
  • p33404495_122140_Generic.zip (SOA One-off)
  • p31857456_122140_Generic.zip (Oracle Service Bus One-off)
  • p30741105_122140_Generic.zip (Oracle Service Bus One-off)
  • p31713053_122140_Linux-x86-64.zip (One-off patch)
  • p34292037_122140_Generic.zip (SOA One-off)

Update required build files

The following files in the code repository location <imagetool-setup-location>/docker-images/OracleSOASuite/imagetool/12.2.1.4.0 are used for creating the image:

• additionalBuildCmds.txt
• buildArgs

1. In the buildArgs file, update all occurrences of %DOCKER_REPO% with the docker-images repository location, which is the complete path of <imagetool-setup-location>/docker-images.

   For example, update:

   %DOCKER_REPO%/OracleSOASuite/imagetool/12.2.1.4.0/

   to:

   <imagetool-setup-location>/docker-images/OracleSOASuite/imagetool/12.2.1.4.0/

2. Similarly, update the placeholders %JDK_VERSION% and %BUILDTAG% with appropriate values.

3. Update the response file <imagetool-setup-location>/docker-images/OracleFMWInfrastructure/dockerfiles/12.2.1.4/install.file to add the parameter INSTALL_TYPE="Fusion Middleware Infrastructure" in the [GENERIC] section.

Create the image

1. Add a JDK package to the WebLogic Image Tool cache:

   $ imagetool cache addInstaller --type jdk --version 8u361 --path <download location>/jdk-8u361-linux-x64.tar.gz
   

2. Add the downloaded installation binaries to the WebLogic Image Tool cache:

   $ imagetool cache addInstaller --type fmw --version 12.2.1.4.0 --path <download location>/fmw_12.2.1.4.0_infrastructure.jar
   
   $ imagetool cache addInstaller --type soa --version 12.2.1.4.0 --path <download location>/fmw_12.2.1.4.0_soa.jar
   
   $ imagetool cache addInstaller --type osb --version 12.2.1.4.0 --path <download location>/fmw_12.2.1.4.0_osb.jar
   
   $ imagetool cache addInstaller --type b2b --version 12.2.1.4.0 --path <download location>/fmw_12.2.1.4.0_b2bhealthcare.jar
   
   

3. Add the downloaded OPatch patch to the WebLogic Image Tool cache:

   $ imagetool cache addEntry --key 28186730_13.9.4.2.11 --value <download location>/p28186730_1394211_Generic.zip
   

4. Append the --opatchBugNumber flag and the OPatch patch key to the create command in the buildArgs file:

   --opatchBugNumber 28186730_13.9.4.2.11
   

5. Add the downloaded product patches to the WebLogic Image Tool cache:

   $ imagetool cache addEntry --key 28186730_13.9.4.2.11 --value <download location>/p28186730_1394211_Generic.zip
   
   $ imagetool cache addEntry --key 30741105_12.2.1.4.0 --value <download location>/p30741105_122140_Generic.zip
   
   $ imagetool cache addEntry --key 33639718_12.2.1.4.0 --value <download location>/p33639718_122140_Linux-x86-64.zip
   
   $ imagetool cache addEntry --key 31713053_12.2.1.4.0 --value <download location>/p31713053_122140_Linux-x86-64.zip
   
   $ imagetool cache addEntry --key 31857456_12.2.1.4.0 --value <download location>/p31857456_122140_Generic.zip
   
   $ imagetool cache addEntry --key 32121987_12.2.1.4.0 --value <download location>/p32121987_122140_Generic.zip
   
   $ imagetool cache addEntry --key 32720458_12.2.1.4.0 --value <download location>/p32720458_122140_Generic.zip
   
   $ imagetool cache addEntry --key 33093748_12.2.1.4.0 --value <download location>/p33093748_122140_Generic.zip
   
   $ imagetool cache addEntry --key 33404495_12.2.1.4.0 --value <download location>/p33404495_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34839859_12.2.1.4.0 --value <download location>/p34839859_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34845927_12.2.1.4.0 --value <download location>/p34845927_122140_Generic.zip
   
   $ imagetool cache addEntry --key 33950717_12.2.1.4.0 --value <download location>/p33950717_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34944256_12.2.1.4.0 --value <download location>/p34944256_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34824004_12.2.1.4.0 --value <download location>/p34824004_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34883826_12.2.1.4.0 --value <download location>/p34883826_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34879707_12.2.1.4.0 --value <download location>/p34879707_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34065178_12.2.1.4.0 --value <download location>/p34065178_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34801809_12.2.1.4.0 --value <download location>/p34801809_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34542329_12.2.1.4.0 --value <download location>/p34542329_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34765492_12.2.1.4.0 --value <download location>/p34765492_122140_Generic.zip
   
   $ imagetool cache addEntry --key 34292037_12.2.1.4.0 --value <download location>/p34292037_122140_Generic.zip
   
   

6. Append the --patches flag and the product patch keys to the create command in the buildArgs file. The --patches list must be a comma-separated collection of patch --key values used in the imagetool cache addEntry commands above.

   Sample --patches list for the product patches added in to the cache:

   --patches 30741105_12.2.1.4.0,33639718_12.2.1.4.0,31713053_12.2.1.4.0,31857456_12.2.1.4.0,32121987_12.2.1.4.0,32720458_12.2.1.4.0,33093748_12.2.1.4.0,33404495_12.2.1.4.0,34839859_12.2.1.4.0,34845927_12.2.1.4.0,33950717_12.2.1.4.0,34944256_12.2.1.4.0,34824004_12.2.1.4.0,34883826_12.2.1.4.0,34879707_12.2.1.4.0,34065178_12.2.1.4.0,34801809_12.2.1.4.0,34542329_12.2.1.4.0,34765492_12.2.1.4.0,34292037_12.2.1.4.0
   

   Example buildArgs file after appending the OPatch patch and product patches:

   create
   --jdkVersion 8u361
   --type soa_osb_b2b
   --version 12.2.1.4.0
   --tag oracle/soasuite:12.2.1.4.0
   --pull
   --fromImage ghcr.io/oracle/oraclelinux:7-slim
   --chown oracle:root
   --additionalBuildCommands <imagetool-setup-location>/docker-images/OracleSOASuite/imagetool/12.2.1.4.0/additionalBuildCmds.txt
   --additionalBuildFiles <imagetool-setup-location>/docker-images/OracleSOASuite/dockerfiles/12.2.1.4/container-scripts
   --installerResponseFile <imagetool-setup-location>/docker-images/OracleFMWInfrastructure/dockerfiles/12.2.1.4/install.file,<imagetool-setup-location>/docker-images/OracleSOASuite/dockerfiles/12.2.1.4/install/soasuite.response,<imagetool-setup-location>/docker-images/OracleSOASuite/dockerfiles/12.2.1.4/install/osb.response,<imagetool-setup-location>/docker-images/OracleSOASuite/dockerfiles/12.2.1.4/install/b2b.response
   --patches 30741105_12.2.1.4.0,33639718_12.2.1.4.0,31713053_12.2.1.4.0,31857456_12.2.1.4.0,32121987_12.2.1.4.0,32720458_12.2.1.4.0,33093748_12.2.1.4.0,33404495_12.2.1.4.0,34839859_12.2.1.4.0,34845927_12.2.1.4.0,33950717_12.2.1.4.0,34944256_12.2.1.4.0,34824004_12.2.1.4.0,34883826_12.2.1.4.0,34879707_12.2.1.4.0,34065178_12.2.1.4.0,34801809_12.2.1.4.0,34542329_12.2.1.4.0,34765492_12.2.1.4.0,34292037_12.2.1.4.0
   

   Note: In the buildArgs file:

   • --jdkVersion value must match the --version value used in the imagetool cache addInstaller command for --type jdk.
   • --version value must match the --version value used in the imagetool cache addInstaller command for --type soa.
   • --pull always pulls the latest base Linux image oraclelinux:7-slim from the Docker registry. This flag can be removed if you want to use the Linux image oraclelinux:7-slim, which is already available on the host where the SOA image is created.

   Refer to this page for the complete list of options available with the WebLogic Image Tool create command.

7. Create the Oracle SOA Suite image:

   $ imagetool @<absolute path to buildargs file>
   

   Note: Make sure that the absolute path to the buildargs file is prepended with a @ character, as shown in the example above.

   For example:

   $ imagetool @<imagetool-setup-location>/docker-images/OracleSOASuite/imagetool/12.2.1.4.0/buildArgs
   

   Click here to see the sample Dockerfile generated with the `imagetool` command.

   ########## BEGIN DOCKERFILE ##########
   # Copyright (c) 2019, 2021, Oracle and/or its affiliates.
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   
   FROM ghcr.io/oracle/oraclelinux:7-slim as os_update
   LABEL com.oracle.weblogic.imagetool.buildid="b4554a25-22dd-4793-b121-9989bd4be40a"
   USER root
   # Use package manager to make sure that unzip, tar, and other required packages are installed
   #
   # Copyright (c) 2021, Oracle and/or its affiliates.
   #
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   # Ensure necessary OS packages are installed
       RUN yum -y --downloaddir=/tmp/imagetool install gzip tar unzip libaio jq findutils diffutils hostname \
       && yum -y --downloaddir=/tmp/imagetool clean all \
       && rm -rf /var/cache/yum/* \
       && rm -rf /tmp/imagetool
   
   
   # Create the Oracle user that will be the owner of the installed software
   #
   # Copyright (c) 2021, Oracle and/or its affiliates.
   #
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   # Create user and group
   RUN if [ -z "$(getent group root)" ]; then hash groupadd &> /dev/null && groupadd root || exit -1 ; fi \
   && if [ -z "$(getent passwd oracle)" ]; then hash useradd &> /dev/null && useradd -g root oracle || exit -1; fi \
   && mkdir -p /u01 \
   && chown oracle:root /u01 \
   && chmod 775 /u01
   
   # If Java is not already in the base image, install it
       # Copyright (c) 2021, Oracle and/or its affiliates.
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   # Installing Java
   
   FROM os_update as jdk_build
   LABEL com.oracle.weblogic.imagetool.buildid="b4554a25-22dd-4793-b121-9989bd4be40a"
   
   ENV JAVA_HOME=/u01/jdk
   
   COPY --chown=oracle:root jdk-8u301-linux-x64.tar.gz /tmp/imagetool/
   
   USER oracle
   
   
   RUN tar xzf /tmp/imagetool/jdk-8u301-linux-x64.tar.gz -C /u01 \
   && $(test -d /u01/jdk* && mv /u01/jdk* /u01/jdk || mv /u01/graal* /u01/jdk) \
   && rm -rf /tmp/imagetool \
   && rm -f /u01/jdk/javafx-src.zip /u01/jdk/src.zip
   
   
   
   # If an Oracle Home is not already in the base image, install the middleware components
       # Copyright (c) 2021, Oracle and/or its affiliates.
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   # Installing Middleware
   
   FROM os_update as wls_build
   LABEL com.oracle.weblogic.imagetool.buildid="b4554a25-22dd-4793-b121-9989bd4be40a"
   
   ENV JAVA_HOME=/u01/jdk \
   ORACLE_HOME=/u01/oracle \
   OPATCH_NO_FUSER=true
   
   RUN mkdir -p /u01/oracle \
   && mkdir -p /u01/oracle/oraInventory \
   && chown oracle:root /u01/oracle/oraInventory \
   && chown oracle:root /u01/oracle
   
   COPY --from=jdk_build --chown=oracle:root /u01/jdk /u01/jdk/
   
   COPY --chown=oracle:root fmw_12.2.1.4.0_infrastructure.jar install.file /tmp/imagetool/
   COPY --chown=oracle:root fmw_12.2.1.4.0_soa.jar soasuite.response /tmp/imagetool/
   COPY --chown=oracle:root fmw_12.2.1.4.0_osb.jar osb.response /tmp/imagetool/
   COPY --chown=oracle:root fmw_12.2.1.4.0_b2bhealthcare.jar b2b.response /tmp/imagetool/
   COPY --chown=oracle:root oraInst.loc /u01/oracle/
   
   USER oracle
   
   
   RUN echo "INSTALLING MIDDLEWARE" \
       && echo "INSTALLING fmw" \
       &&  \
       /u01/jdk/bin/java -Xmx1024m -jar /tmp/imagetool/fmw_12.2.1.4.0_infrastructure.jar -silent ORACLE_HOME=/u01/oracle \
       -responseFile /tmp/imagetool/install.file -invPtrLoc /u01/oracle/oraInst.loc -ignoreSysPrereqs -force -novalidation \
       && echo "INSTALLING soa" \
       &&  \
       /u01/jdk/bin/java -Xmx1024m -jar /tmp/imagetool/fmw_12.2.1.4.0_soa.jar -silent ORACLE_HOME=/u01/oracle \
       -responseFile /tmp/imagetool/soasuite.response -invPtrLoc /u01/oracle/oraInst.loc -ignoreSysPrereqs -force -novalidation \
       && echo "INSTALLING osb" \
       &&  \
       /u01/jdk/bin/java -Xmx1024m -jar /tmp/imagetool/fmw_12.2.1.4.0_osb.jar -silent ORACLE_HOME=/u01/oracle \
       -responseFile /tmp/imagetool/osb.response -invPtrLoc /u01/oracle/oraInst.loc -ignoreSysPrereqs -force -novalidation \
       && echo "INSTALLING b2b" \
       &&  \
       /u01/jdk/bin/java -Xmx1024m -jar /tmp/imagetool/fmw_12.2.1.4.0_b2bhealthcare.jar -silent ORACLE_HOME=/u01/oracle \
       -responseFile /tmp/imagetool/b2b.response -invPtrLoc /u01/oracle/oraInst.loc -ignoreSysPrereqs -force -novalidation \
   && test $? -eq 0 \
   && chmod -R g+r /u01/oracle \
   || (grep -vh "NOTIFICATION" /tmp/OraInstall*/install*.log && exit 1)
   
   #
   # Copyright (c) 2021, Oracle and/or its affiliates.
   #
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   # Update OPatch and apply WebLogic patches
       COPY --chown=oracle:root p28186730_1394211_Generic.zip /tmp/imagetool/opatch/
       RUN cd /tmp/imagetool/opatch \
       && /u01/jdk/bin/jar -xf /tmp/imagetool/opatch/p28186730_1394211_Generic.zip \
       && /u01/jdk/bin/java -jar /tmp/imagetool/opatch/6880880/opatch_generic.jar -silent -ignoreSysPrereqs -force -novalidation oracle_home=/u01/oracle \
       && rm -rf /tmp/imagetool
   
       COPY --chown=oracle:root patches/* /tmp/imagetool/patches/
   
           # Apply all patches provided at the same time
           RUN /u01/oracle/OPatch/opatch napply -silent -oh /u01/oracle -nonrollbackable -phBaseDir /tmp/imagetool/patches \
           && test $? -eq 0 \
           && /u01/oracle/OPatch/opatch util cleanup -silent -oh /u01/oracle
   
   
   
   
   
   FROM os_update as final_build
   
   ENV ORACLE_HOME=/u01/oracle \
       JAVA_HOME=/u01/jdk \
       PATH=${PATH}:/u01/jdk/bin:/u01/oracle/oracle_common/common/bin:/u01/oracle/wlserver/common/bin:/u01/oracle
   
   LABEL com.oracle.weblogic.imagetool.buildid="b4554a25-22dd-4793-b121-9989bd4be40a"
   
       COPY --from=jdk_build --chown=oracle:root /u01/jdk /u01/jdk/
   
       COPY --from=wls_build --chown=oracle:root /u01/oracle /u01/oracle/
   
   
   
   USER oracle
   WORKDIR /u01/oracle
   
   #ENTRYPOINT /bin/bash
   
   
       ENV ORACLE_HOME=/u01/oracle \
           VOLUME_DIR=/u01/oracle/user_projects \
           SCRIPT_FILE=/u01/oracle/container-scripts/* \
           HEALTH_SCRIPT_FILE=/u01/oracle/container-scripts/get_healthcheck_url.sh \
           JAVA_OPTIONS="-Doracle.jdbc.fanEnabled=false -Dweblogic.StdoutDebugEnabled=false" \
           PATH=$PATH:/u01/oracle/container-scripts:/u01/oracle/oracle_common/modules/thirdparty/org.apache.ant/1.10.5.0.0/apache-ant-1.10.5/bin
   
       USER root
       RUN mkdir -p $VOLUME_DIR && chown oracle:root /u01 $VOLUME_DIR && \
           mkdir -p /u01/oracle/container-scripts
   
       COPY --chown=oracle:root files/container-scripts/ /u01/oracle/container-scripts/
       RUN chmod +xr $SCRIPT_FILE
   
       USER oracle
   
       RUN if [ -f "${ORACLE_HOME}/soa/soa/thirdparty/edifecs/XEngine_8_4_1_23.tar.gz" ]; then \
               cd $ORACLE_HOME/soa/soa/thirdparty/edifecs && \
               tar -zxvf  XEngine_8_4_1_23.tar.gz; \
           else \
               echo -e "\nXEngine_8_4_1_23.tar.gz not present in ${ORACLE_HOME}/soa/soa/thirdparty/edifecs directory. Skipping untar."; \
           fi
       HEALTHCHECK --start-period=5m --interval=1m CMD curl -k -s --fail `$HEALTH_SCRIPT_FILE` || exit 1
       WORKDIR ${ORACLE_HOME}
       CMD ["/u01/oracle/container-scripts/createDomainAndStart.sh"]
   
   ########## END DOCKERFILE ##########
   

8. Check the created image using the docker images command:

     $ docker images | grep soasuite
   

Update an image

After setting up the WebLogic Image Tool and required build scripts, use the WebLogic Image Tool to update an existing Oracle SOA Suite Docker image:

1. Enter the following command to add the OPatch patch to the WebLogic Image Tool cache:

   $ imagetool cache addEntry --key 28186730_13.9.4.2.11 --value <download location>/p28186730_1394211_Generic.zip
   

2. Execute the imagetool cache addEntry command for each patch to add the required patch(es) to the WebLogic Image Tool cache. For example, to add patch p30761841_122140_Generic.zip:

   $ imagetool cache addEntry --key=30761841_12.2.1.4.0 --value <downloaded-patches-location>/p30761841_122140_Generic.zip
   

3. Provide the following arguments to the WebLogic Image Tool update command:

   • –-fromImage - Identify the image that needs to be updated. In the example below, the image to be updated is soasuite:12.2.1.4.
   • –-patches - Multiple patches can be specified as a comma-separated list.
   • --tag - Specify the new tag to be applied for the image being built.

   Refer here for the complete list of options available with the WebLogic Image Tool update command.

   Note: The WebLogic Image Tool cache should have the latest OPatch zip. The WebLogic Image Tool will update the OPatch if it is not already updated in the image.

   Examples

   Click here to see the example 'update' command:

   $ imagetool update --fromImage soasuite:12.2.1.4 --chown oracle:root --tag=soasuite:12.2.1.4-30761841 --patches=30761841_12.2.1.4.0 --opatchBugNumber=28186730_13.9.4.2.11
   
     [INFO   ] Image Tool build ID: bd21dc73-b775-4186-ae03-8219bf02113e
     [INFO   ] Temporary directory used for docker build context: <work-directory>/wlstmp/wlsimgbuilder_temp1117031733123594064
     [INFO   ] Using patch 28186730_13.9.4.2.11 from cache: <downloaded-patches-location>/p28186730_1394211_Generic.zip
     [WARNING] skipping patch conflict check, no support credentials provided
     [WARNING] No credentials provided, skipping validation of patches
     [INFO   ] Using patch 30761841_12.2.1.4.0 from cache: <downloaded-patches-location>/p30761841_122140_Generic.zip
     [INFO   ] docker cmd = docker build --force-rm=true --no-cache --tag soasuite:12.2.1.4-30761841 --build-arg http_proxy=http://<YOUR-COMPANY-PROXY> --build-arg https_proxy=http://<YOUR-COMPANY-PROXY> --build-arg no_proxy=<IP addresses and Domain address for no_proxy>,/var/run/docker.sock <work-directory>/wlstmp/wlsimgbuilder_temp1117031733123594064
     Sending build context to Docker daemon  53.47MB
   
     Step 1/7 : FROM soasuite:12.2.1.4 as FINAL_BUILD
     ---> 445b649a3459
     Step 2/7 : USER root
     ---> Running in 27f45e6958c3
     Removing intermediate container 27f45e6958c3
     ---> 150ae0161d46
     Step 3/7 : ENV OPATCH_NO_FUSER=true
     ---> Running in daddfbb8fd9e
     Removing intermediate container daddfbb8fd9e
     ---> a5fc6b74be39
     Step 4/7 : LABEL com.oracle.weblogic.imagetool.buildid="bd21dc73-b775-4186-ae03-8219bf02113e"
     ---> Running in cdfec79c3fd4
     Removing intermediate container cdfec79c3fd4
     ---> 4c773aeb956f
     Step 5/7 : USER oracle
     ---> Running in ed3432e43e89
     Removing intermediate container ed3432e43e89
     ---> 54fe6b07c447
     Step 6/7 : COPY --chown=oracle:oracle patches/* /tmp/imagetool/patches/
     ---> d6d12f02a9be
     Step 7/7 : RUN /u01/oracle/OPatch/opatch napply -silent -oh /u01/oracle -phBaseDir /tmp/imagetool/patches     && /u01/oracle/OPatch/opatch util cleanup -silent -oh /u01/oracle     && rm -rf /tmp/imagetool
     ---> Running in a79addca4d2f
     Oracle Interim Patch Installer version 13.9.4.2.5
     Copyright (c) 2020, Oracle Corporation.  All rights reserved.
   
   
     Oracle Home       : /u01/oracle
     Central Inventory : /u01/oracle/oraInventory
       from           : /u01/oracle/oraInst.loc
     OPatch version    : 13.9.4.2.5
     OUI version       : 13.9.4.0.0
     Log file location : /u01/oracle/cfgtoollogs/opatch/opatch2020-06-01_10-56-13AM_1.log
   
   
     OPatch detects the Middleware Home as "/u01/oracle"
   
     Verifying environment and performing prerequisite checks...
     OPatch continues with these patches:   30761841
   
     Do you want to proceed? [y|n]
     Y (auto-answered by -silent)
     User Responded with: Y
     All checks passed.
   
     Please shutdown Oracle instances running out of this ORACLE_HOME on the local system.
     (Oracle Home = '/u01/oracle')
   
   
     Is the local system ready for patching? [y|n]
     Y (auto-answered by -silent)
     User Responded with: Y
     Backing up files...
     Applying interim patch '30761841' to OH '/u01/oracle'
     ApplySession: Optional component(s) [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.55.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.55.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.5.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.5.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.55.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.55.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.52.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.52.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.48.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.48.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.49.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.49.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.51.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.51.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.54.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.54.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.54.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.54.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.5.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.5.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.54.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.54.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.55.0.0.0 ] , [ oracle.org.bouncycastle.bcpkix.jdk15on, 1.55.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.49.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.49.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.5.0.0.0 ] , [ oracle.org.bouncycastle.bcprov.jdk15on, 1.5.0.0.0 ]  not present in the Oracle Home or a higher version is found.
   
     Patching component oracle.org.bouncycastle.bcprov.jdk15on, 1.60.0.0.0...
   
     Patching component oracle.org.bouncycastle.bcprov.jdk15on, 1.60.0.0.0...
   
     Patching component oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.60.0.0.0...
   
     Patching component oracle.org.bouncycastle.bcprov.ext.jdk15on, 1.60.0.0.0...
   
     Patching component oracle.org.bouncycastle.bcpkix.jdk15on, 1.60.0.0.0...
   
     Patching component oracle.org.bouncycastle.bcpkix.jdk15on, 1.60.0.0.0...
     Patch 30761841 successfully applied.
     Log file location: /u01/oracle/cfgtoollogs/opatch/opatch2020-06-01_10-56-13AM_1.log
   
     OPatch succeeded.
     Oracle Interim Patch Installer version 13.9.4.2.5
     Copyright (c) 2020, Oracle Corporation.  All rights reserved.
   
   
     Oracle Home       : /u01/oracle
     Central Inventory : /u01/oracle/oraInventory
       from           : /u01/oracle/oraInst.loc
     OPatch version    : 13.9.4.2.5
     OUI version       : 13.9.4.0.0
     Log file location : /u01/oracle/cfgtoollogs/opatch/opatch2020-06-01_10-57-19AM_1.log
   
   
     OPatch detects the Middleware Home as "/u01/oracle"
   
     Invoking utility "cleanup"
     OPatch will clean up 'restore.sh,make.txt' files and 'scratch,backup' directories.
     You will be still able to rollback patches after this cleanup.
     Do you want to proceed? [y|n]
     Y (auto-answered by -silent)
     User Responded with: Y
   
     Backup area for restore has been cleaned up. For a complete list of files/directories
     deleted, Please refer log file.
   
     OPatch succeeded.
     Removing intermediate container a79addca4d2f
     ---> 2ef2a67a685b
     Successfully built 2ef2a67a685b
     Successfully tagged soasuite:12.2.1.4-30761841
     [INFO   ] Build successful. Build time=112s. Image tag=soasuite:12.2.1.4-30761841
   

   Click here to see the example Dockerfile generated by the WebLogic Image Tool with the '--dryRun' option:

   $ imagetool update --fromImage soasuite:12.2.1.4 --chown oracle:root --tag=soasuite:12.2.1.4-30761841 --patches=30761841_12.2.1.4.0 --opatchBugNumber=28186730_13.9.4.2.11 --dryRun
   
   [INFO ] Image Tool build ID: f9feea35-c52c-4974-b155-eb7f34d95892
   [INFO ] Temporary directory used for docker build context: <work-directory>/wlstmp/wlsimgbuilder_temp1799120592903014749
   [INFO ] Using patch 28186730_13.9.4.2.11 from cache: <downloaded-patches-location>/p28186730_1394211_Generic.zip
   [WARNING] skipping patch conflict check, no support credentials provided
   [WARNING] No credentials provided, skipping validation of patches
   [INFO ] Using patch 30761841_12.2.1.4.0 from cache: <downloaded-patches-location>/p30761841_122140_Generic.zip
   [INFO ] docker cmd = docker build --force-rm=true --no-cache --tag soasuite:12.2.1.4-30761841 --build-arg http_proxy=http://www.yourcompany.proxy.com:80 --build-arg https_proxy=http://www.yourcompany.proxy.com:80 --build-arg no_proxy=10.250.109.251,localhost,127.0.0.1,/var/run/docker.sock <work-directory>/wlstmp/wlsimgbuilder_temp1799120592903014749
   ########## BEGIN DOCKERFILE ##########
   #
   # Copyright (c) 2019, 2020, Oracle and/or its affiliates.
   #
   # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
   #
   #
   
   FROM soasuite:12.2.1.4 as FINAL_BUILD
   USER root
   
   ENV OPATCH_NO_FUSER=true
   
   
   LABEL com.oracle.weblogic.imagetool.buildid="f9feea35-c52c-4974-b155-eb7f34d95892"
   
   USER oracle
   
   
   COPY --chown=oracle:oracle patches/* /tmp/imagetool/patches/
   
   RUN /u01/oracle/OPatch/opatch napply -silent -oh /u01/oracle -phBaseDir /tmp/imagetool/patches \
   && /u01/oracle/OPatch/opatch util cleanup -silent -oh /u01/oracle \
   && rm -rf /tmp/imagetool
   
   
   
   
   ########## END DOCKERFILE ##########
   

4. Check the built image using the docker images command:

     $ docker images | grep soasuite
     soasuite   12.2.1.4-30761841
     2ef2a67a685b        About a minute ago   4.84GB
     $
   

Create an Oracle SOA Suite Docker image using Dockerfile

For test and development purposes, you can create an Oracle SOA Suite image using the Dockerfile. Consult the README file for important prerequisite steps, such as building or pulling the Server JRE Docker image, Oracle FMW Infrastructure Docker image, and downloading the Oracle SOA Suite installer and bundle patch binaries.

A prebuilt Oracle Fusion Middleware Infrastructure image, container-registry.oracle.com/middleware/fmw-infrastructure:12.2.1.4, is available at container-registry.oracle.com. We recommend that you pull and rename this image to build the Oracle SOA Suite image.

  $ docker pull container-registry.oracle.com/middleware/fmw-infrastructure:12.2.1.4
  $ docker tag container-registry.oracle.com/middleware/fmw-infrastructure:12.2.1.4  oracle/fmw-infrastructure:12.2.1.4.0

Follow these steps to build an Oracle Fusion Middleware Infrastructure image, and then the Oracle SOA Suite image as a layer on top of that:

1. Make a local clone of the sample repository:

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

2. Build the oracle/fmw-infrastructure:12.2.1.4 image:

    $ cd docker-images/OracleFMWInfrastructure/dockerfiles
    $ sh buildDockerImage.sh -v 12.2.1.4 -s
   

   This will produce an image named oracle/fmw-infrastructure:12.2.1.4.

3. Tag the image as follows:

     $ docker tag oracle/fmw-infrastructure:12.2.1.4  oracle/fmw-infrastructure:12.2.1.4.0
   

4. Download the Oracle SOA Suite installer from the Oracle Technology Network or e-delivery.

   Note: Copy the installer binaries to the same location as the Dockerfile.

5. To build the Oracle SOA Suite image with patches, you must download and drop the patch zip files (for example, p29928100_122140_Generic.zip) into the patches/ folder under the version that is required. For example, for 12.2.1.4.0 the folder is 12.2.1.4/patches. Similarly, to build the image by including the OPatch patch, download and drop the OPatch patch zip file (for example, p28186730_1394211_Generic.zip) into the opatch_patch/ folder.

6. Create the Oracle SOA Suite image by running the provided script:

   $ cd docker-images/OracleSOASuite/dockerfiles
   $ ./buildDockerImage.sh -v 12.2.1.4 -s
   

   The image produced will be named oracle/soasuite:12.2.1.4. The samples and instructions assume the Oracle SOA Suite image is named soasuite:12.2.1.4. You must rename your image to match this name, or update the samples to refer to the image you created.

   $ docker tag oracle/soasuite:12.2.1.4 soasuite:12.2.1.4