iMingLei / docker-apex-stack

Utility scripts for creating an Oracle Application Express stack as a Docker container.

Build an APEX Stack with Docker

For background information on this repository, please read this blog post.

Prerequisites

• sudo rights.
• Installed the following:
  • Git
  • Curl
  • Docker (of course)

IMPORTANT

Build and execution has been tested in Linux only. It should work in Mac OS, but likely not with Windows. Sorry.

Getting Started

1. Git clone this repository and set it as the working directory.
2. Download the installer files:
   • Oracle Database 18c XE
   • Oracle Application Express (the latest version is 18.2 as of February 16, 2019)
   • Oracle REST Data Services (the latest version is 18.4 as of February 16, 2019)
3. Place all three files in the sub-directory files.
4. Run the first script to grab the latest Docker images from Oracle:

   $ . 01-stage.sh

5. Create a new file that contains the required variables. The sample.env file is provided and can be used, otherwise, modify as desired. The file should contain the following variables:

   ORACLE_SID=XE
   ORACLE_PDB=XEPDB1
   ORACLE_PWD=Oracle18
   APEX_ADMIN_EMAIL=[e-mail]
   APEX_ADMIN_PWD=Oracle__18
   INSTALL_FILE_APEX=apex_18.2.zip
   INSTALL_FILE_ORDS=ords-18.4.0.354.1002.zip
   DOCKER_ORDS_PORT=50080
   DOCKER_EM_PORT=55500
   DOCKER_DB_PORT=51521
   DB_VERSION=18.4.0
   DB_EDITION=XE

6. Run the second script to build the Oracle Database image, where the environment file is called mysettings.env:

   $ . 02-build.sh mysettings.env

7. Run the final script to create and run the container, where the container name is axer (it is preferred that you execute a command using sudo before executing this script):

   $ . 03-run.sh axer mysettings.env

Using the sample settings, the following are accessible:

Port	Application	URL
50080	APEX	http://localhost:50080
51521	Database	N/A
55500	Enterprise Manager Express	https://localhost:55500/em