Creating an Oracle REST Data Services Docker image

My environment as of writing this blog is as follows:

Once you have the file, copy it into the OracleJava/java-8 folder and run the Java Server JRE Docker build.sh script:

That’s it! Now you have a brand new oracle/serverjre:8 Docker image:

Once you have the oracle/serverjre:8 Docker image on your machine you can now go ahead and build the actual ORDS Docker image. This is also a rather easy task, just put the installer zip file into the OracleRestDataServices/dockerfiles/ folder and run the buildDockerImage.sh script:

And now you have a brand new ORDS Docker image, in my case containing ORDS 18.1.1:

There is one last thing to add here: By default the buildDockerImage.sh script runs a md5sum checksum on the ORDS zip file just to make sure that the file is intact. You see this as the very first output of the build script. You can skip that checksum by passing on the -i option. In general there is no need to skip the checksum step, however, ORDS releases on a quarterly basis and it may be the case that the GitHub repo hasn’t been updated with the latest checksum files yet. In such case you can still build your latest and greatest ORDS Docker image by bypassing the checksum via -i.

Now that you have an ORDS Docker image it’s time to run an actual container of it. As ORDS is a REST server in front of an Oracle Database you will need an Oracle Database that ORDS can REST-enable for you. I already do have my Oracle Database Docker images on the same machine and so I will go ahead and REST-enable a database within a Docker container. However, I should point out that having an Oracle Database inside a Docker container is no requirement for running ORDS inside Docker! In fact, you can quite happily manage many Oracle databases with ORDS, regardless where your Oracle databases are running, Docker, locally, on a server, in the cloud, etc.

If your Oracle Database is not running inside a Docker container, you can skip this step!

Because the database and ORDS are both running within Docker I first have to setup a Docker network that these two containers can use to communicate with each other. Creating the network is easily done with just a simple command docker network create:

If your Oracle Database is not running inside a Docker container, you can skip this step!

Once you have the network defined you can now start a new Oracle Database container. The --network option in the docker run command will allow you to attach your database container to the Docker network:

To run an ORDS Docker container you will have to know the following details:

Once you have all of these you can go ahead and run your ORDS Docker container via the docker run command.

If you do not have the Oracle Database running in Docker, you can skip the --network parameter!

Now that ORDS is up and running, you can start REST-enabling your database. Note that all configuration files are within a volume, in my case -v /home/oracle/ords:/opt/oracle/ords/config/ords:rw. If you would like to change any of the ORDS configuration, you can just do so in the volume and then restart the container, if needed.

Related posts:

Humans are made to mistake and every single mistake is key to success. Success can be achieved either by sharing gratitude, Kindness, and positivity in the environment. Even showing these skills are…

When it comes to summer, nothing is better than a festival! And of course, it ’s fun to have a lot of people gather at the festival! If you win first place in all event races, the maximum prize will…