Skip to content

Latest commit

 

History

History
204 lines (126 loc) · 9.12 KB

README-OCR-Base.md

File metadata and controls

204 lines (126 loc) · 9.12 KB
Raw

Building an Oracle Identity Governance Image using Dockerfiles, Scripts and Base Image from Oracle Container Registry (OCR)

Sample Docker configurations to facilitate installation, configuration, and environment setup for Docker users. This image includes binaries for Oracle Identity Governance (OIG) Release 12.2.1.4.0 and it has capability to create FMW Infrastructure domain and OIG specific Managed Servers.

Image: oracle/oig:<version; example:12.2.1.4.0>

Prerequisites

The following prerequisites are necessary before building OIG images:

  • A working installation of Docker 18.03 or later

Hardware Requirements

Hardware Size
RAM Min 16GB
Disk Space Min 50GB (ensure 10G+ available in Docker Home)

How to build

This project offers a sample Dockerfile and scripts to build an Oracle Identity Governance 12cPS4 (12.2.1.4) image.

Building your own OIG image involves the following steps:

  • Pulling the Oracle SOA 12.2.1.4 image
  • Downloading the OIG Docker files
  • Downloading the 12.2.1.4.0 Identity Management shiphome and Patches
  • Building the OIG image

Pulling the Oracle SOA 12.2.1.4 image

  1. Launch a browser and access the Oracle Container Registry.
  2. Click Sign In and login with your username and password.
  3. In the Search field enter soasuite and press Enter.
  4. Click soasuite Oracle SOA Suite.
  5. In the Terms and Conditions box, select Language as English. Click Continue and ACCEPT "Terms and Restrictions".
  6. On your Docker environment login to the Oracle Container Registry and enter your Oracle SSO username and password when prompted:
$ docker login container-registry.oracle.com
Username: <username>
Password: <password>

For example:

$ docker login container-registry.oracle.com
Username: [email protected]
Password:
Login Succeeded
  1. Pull the latest soasuite image:
$ docker pull container-registry.oracle.com/middleware/soasuite:12.2.1.4

The output should look similar to the following:

Trying to pull repository container-registry.oracle.com/middleware/soasuite ...
12.2.1.4: Pulling from container-registry.oracle.com/middleware/soasuite
bce8f778fef0: Already exists
22d5d74b4d76: Pull complete
666dccc4b57a: Pull complete
80745fc9ee3c: Pull complete
330be4fba4b8: Pull complete
98abb7fffaf5: Pull complete
1a4ca5ca35b5: Pull complete
67d3ca48ddaf: Pull complete
Digest: sha256:6f9b1985e6ce9dbc81f2b9ace210f5ab3e791874ffa9337888f9d788d47a35be
Status: Downloaded newer image for container-registry.oracle.com/middleware/soasuite:12.2.1.4
container-registry.oracle.com/middleware/soasuite:12.2.1.4
  1. Run the docker tag command to tag the image as follows:
docker tag container-registry.oracle.com/middleware/soasuite:12.2.1.4 fmw-soa:12.2.1.4.0

No output is returned to the screen.

  1. Run the docker images command to show the image is installed into the repository. The output should look similar to this:
$ docker images

REPOSITORY                                                    TAG                 IMAGE ID            CREATED             SIZE
fmw-soa                                                       12.2.1.4.0          6d61b77a1e9c        2 weeks ago         4.55GB
container-registry.oracle.com/middleware/soasuite             12.2.1.4            6d61b77a1e9c        2 weeks ago         4.55GB

Downloading the OIG Docker files

  1. Make a work directory to place the OIG Docker files:
$ mkdir <work directory>
  1. Download the OIG Docker files from the OIG repository by running the following command:
$ cd <work directory>
$ git clone https://github.com/oracle/docker-images/

Downloading the 12.2.1.4.0 Identity Management shiphome and Patches

  1. Download the Oracle Identity and Access Management 12cPS4 software to a stage directory. Unzip the downloaded fmw_12.2.1.4.0_idm_Disk1_1of1.zip file and copy the fmw_12.2.1.4.0_idm.jar to <work directory>/docker-images/OracleIdentityManagement/dockerfiles/12.2.1.4.0/:
$ unzip fmw_12.2.1.4.0_idm_Disk1_1of1.zip
$ cp fmw_12.2.1.4.0_idm.jar <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/fmw_12.2.1.4.0_idm_generic.jar

Note: The filename must be changed to fmw_12.2.1.4.0_idm_generic.jar when copying to the 12.2.1.4.0 directory.

  1. If you require patches in your image, you should complete the following steps:

  • Create the following directories under the 12.2.1.4.0 directory:

    $ mkdir -p <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/patches

    $ mkdir -p <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/opatch_patch

  • Download any patches required from My Oracle Support.

  • Copy any Opatch patches to <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/opatch_patch/.

  • Copy the rest of the patches to <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/patches/.

  • Run the following command to change the permissions on the patch files:

    $ chmod 644 <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/patches/*

    $ chmod 644 <work directory>/docker-images/OracleIdentityGovernance/dockerfiles/12.2.1.4.0/opatch_patch/*

Building the Oracle Identity Governance 12.2.1.x image

  1. Run the following to set the proxy server appropriately. This is required so the build process can pull the relevant Linux packages via yum:
$ export http_proxy=http://<proxy_server_hostname>:<proxy_server_port>
$ export https_proxy=http://<proxy_server_hostname>:<proxy_server_port>
  1. Run the following command to build the OIG image:
$ cd <work directory>/docker-images/OracleIdentityGovernance/dockerfiles
$ sh buildDockerImage.sh -v 12.2.1.4.0

The output should look similar to the following:

version --> 12.2.1.4.0
Proxy settings were found and will be used during build.
Building image 'oracle/oig:12.2.1.4.0' ...
Proxy Settings ' --build-arg http_proxy=http://proxy.example.com:80 --build-arg https_proxy=http://proxy.example.com:80 --build-arg'
Sending build context to Docker daemon  1.471GB
Step 1/15 : FROM fmw-soa:12.2.1.4.0

...

OPatch succeeded.
Removing intermediate container 04434d5f71f4
 ---> a1b93666eec6
Step 15/15 : CMD ["/u01/oracle/dockertools/createDomainAndStart.sh"]
 ---> Running in 94cd000b0c83
Removing intermediate container 94cd000b0c83
 ---> b7073c584105
Successfully built b7073c584105
Successfully tagged oracle/oig:12.2.1.4.0

  Oracle OIM suite Docker Image for version: 12.2.1.4.0 is ready to be extended.

    --> oracle/oig:12.2.1.4.0

  Build completed in 746 seconds.
  1. Run the docker images command to show the OIG image is installed into the repository:
$ docker images

The output should look similar to the following:

REPOSITORY                                                  TAG             IMAGE ID      CREATED             SIZE
oracle/oig                                                  12.2.1.4.0      b7073c584105  3 minutes ago       7.88GB
container-registry.oracle.com/soasuite                      2.2.1.4-200612  9e9262639994  6 weeks ago         2.32GB
oracle/soasuite                                             12.2.1.4.0      9e9262639994  6 weeks ago         2.32GB

The OIG image is now built successfully!

To create OIG Docker containers refer to the OIG Docker Container Configuration below.

OIG Docker Container Configuration

To configure the OIG Docker Containers follow the tutorial Creating Oracle Identity Governance Docker Containers

OIG Kubernetes Configuration

To configure the OIG Containers with Kubernetes see the Oracle Identity Governance on Kubernetes documentation.

Licensing & Copyright

License

To download and run Oracle Fusion Middleware products, regardless whether inside or outside a 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/OracleIdentityGovernance repository required to build the images are, unless otherwise noted, released under UPL 1.0 license.

Copyright

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