Prepare Your Environment

  1. Check the Kubernetes cluster is ready
  2. Obtain the OID container image
  3. Setup the code repository to deploy OID

Check the Kubernetes cluster is ready

  1. Run the following command on the master node to check the cluster and worker nodes are running:

    $ kubectl get nodes,pods -n kube-system

    The output will look similar to the following:

    NAME                  STATUS   ROLES                  AGE   VERSION
node/worker-node1     Ready    <none>                 17h   v1.20.10
node/worker-node2     Ready    <none>                 17h   v1.20.10
node/master-node      Ready    control-plane,master   23h   v1.20.10

NAME                                      READY   STATUS    RESTARTS   AGE
pod/coredns-66bff467f8-slxdq              1/1     Running   1          67d
pod/coredns-66bff467f8-v77qt              1/1     Running   1          67d
pod/etcd-10.89.73.42                      1/1     Running   1          67d
pod/kube-apiserver-10.89.73.42            1/1     Running   1          67d
pod/kube-controller-manager-10.89.73.42   1/1     Running   27         67d
pod/kube-flannel-ds-amd64-r2m8r           1/1     Running   2          48d
pod/kube-flannel-ds-amd64-rdhrf           1/1     Running   2          6d1h
pod/kube-flannel-ds-amd64-vpcbj           1/1     Running   3          66d
pod/kube-proxy-jtcxm                      1/1     Running   1          67d
pod/kube-proxy-swfmm                      1/1     Running   1          66d
pod/kube-proxy-w6x6t                      1/1     Running   1          66d
pod/kube-scheduler-10.89.73.42            1/1     Running   29         67d

Obtain the OID container image

The OID Kubernetes deployment requires access to an OID container image. The image can be obtained in the following ways:

  • Prebuilt OID container image
  • Build your own OID container image using WebLogic Image Tool

Prebuilt OID container image

The latest prebuilt OID container image can be downloaded from Oracle Container Registry. This image is prebuilt by Oracle and includes Oracle Internet Directory 12.2.1.4.0 and the latest PSU.

Note: Before using this image you must login to Oracle Container Registry, navigate to Middleware > oid_cpu and accept the license agreement.

Alternatively the same image can also be downloaded from My Oracle Support by referring to the document ID 2723908.1.

You can use this image in the following ways:

  • Pull the container image from the Oracle Container Registry automatically during the OID Kubernetes deployment.
  • Manually pull the container image from the Oracle Container Registry or My Oracle Support, and then upload it to your own container registry.
  • Manually pull the container image from the Oracle Container Registry or My Oracle Support and manually stage it on the master node and each worker node.

Build your own OID container image using WebLogic Image Tool

You can build your own OID container image using the WebLogic Image Tool. This is recommended if you need to apply one off patches to a Prebuilt OID container image. For more information about building your own container image with WebLogic Image Tool, see Create or update an image.

You can use an image built with WebLogic Image Tool in the following ways:

  • Manually upload them to your own container registry.
  • Manually stage them on the master node and each worker node.

Note: This documentation does not tell you how to pull or push the above images into a private container registry, or stage them on the master and worker nodes. Details of this can be found in the Enterprise Deployment Guide.

Setup the Code repository to deploy OID

Oracle Internet Directory deployment on Kubernetes leverages deployment scripts provided by Oracle for creating Oracle Internet Directory containers using the Helm charts provided. To deploy Oracle Internet Directory on Kubernetes you should set up the deployment scripts on the master node as below:

  1. Create a working directory to setup the source code.

    $ mkdir <workdir>

    For example:

    $ mkdir /scratch/OIDContainer

  2. Download the latest OID deployment scripts from the OID repository:

    $ cd <workdir>
$ git clone https://github.com/oracle/fmw-kubernetes.git --branch release/22.2.1

    For example:

    $ cd /scratch/OIDContainer
$ git clone https://github.com/oracle/fmw-kubernetes.git --branch release/22.2.1

  3. Set the $WORKDIR environment variable as follows:

    $ export WORKDIR=<workdir>/fmw-kubernetes/OracleInternetDirectory

    For example:

    $ export WORKDIR=/scratch/OIDContainer/fmw-kubernetes/OracleInternetDirectory

    You are now ready to create the OID deployment as per Create OID instances.