miniOrange Authentication Service-Docker

  • This document assumes that you already have a working installation of docker.
  • This document also assumes that you will be working in a *nix-like environment.
  • This document will guide you through the processes and steps required to deploy the On-premise version of the miniOrange Authentication Service.

You must have recieved a Dockerfile along with this document. This will help you to create/build a Docker Image.

Creating and Managing the Docker Image

Building your Docker Image

  • Place the Dockerfile in a desired directory. We will be using ~/moas in this example.
  • Build the Docker Image by running the following command:

    docker build -t miniorange/moas-idp-3.3.38 ~/moas --no-cache
  • The build will take about 5-10 minutes, depending upon your internet connection

Running the image in a docker container

  • You can run the docker image by:
    docker run -v :/usr/share/moas/mo-idp-server-3.3.38 --net=bridge --name moas -p 9090:8080 -d miniorange/moas-idp-3.3.0
    • --net-bridge: This connects the container to a bridge network, where the host machine is the gateway. Helps if the container needs to connect to other containers. We will be connecting to another container that will host our database.
    • 9090:8080: This will connect the 8080 port of the container to the 9090 port of the host machine.
    • <moas-directory-on-host>: The host directory to map to container’s. This will help with data retention as it will share the specified directory. This directory will contain the entire miniOrange deployment. This will come in handy if something needs to be changed later on.
    • --name moas: This can be any string. This will be a name given to the docker container. This will be used to connect to the docker container later.
  • The image will by default start the Authentication Service. You may connect to your container anytime.

Connecting to your docker container

  • You can connect with the container using the value used with --name parameter that was specified while running the docker container.
    docker exec -it moas bash

    moas is the --name parameter.