Deployment on Docker

Docker is

an open-source project that automates the deployment of software applications inside containers by providing an additional layer of abstraction and automation of OS-level virtualization on Linux. --Wikipedia

InnowayIT application can be deployed on docker. Following are the relevant information for this purpose.

Pre-requisites

1. Download the files from the link provided

2. Run MS SQL Server script to create InnowayIT DB

3. The default schema for deploying innowayit database objects is "innowayit". This schema should be the default schema for the database user specified in DB _USER parameter below.

4. Run following command to check if existing docker images for innowayit are running. First login to linux shell and redirect to root folder.

$ docker ps

5. If any existing image are running you should stop and remove them as follows:

$ docker stop backend
$ docker rm backend
$ docker stop innowayit-fe
$ docker rm innowayit-fe

Deployment of Back end image

1. Login to Linux shell

2. Convert tar file to an image file with the following command:

$ docker load –i innowayit-be.tar

3. Start back-end container with following command. Replace parameters in <> with actual values

$ docker run -d -p 3000:3000/tcp --name backend  
--restart unless-stopped 
-e DB_HOST="<Host Name>" -e DB_USER="<Userid>" 
-e DB_PASSWORD="<password>" -e DB_NAME="<dbName>"
-e clientUrl="<Server Url> " -e baseUrl="http://localhost:3000/"
-e DB_TYPE="mssql" -e DB_PORT=<port number> innowayit-be:<backend version x.y.z.>

Notes:

1. DB_HOST name should the network address of DB server e.g. http://hostname.domain.com

2. clientUrl is the server IP in this format http://0.0.0.0

3. DB_PORT is the port number on which SQL Server is listening. Default is 1433 but it is often changed to enhance security

Deployment of Front end

1. Login to Linux shell

2. Convert tar file to an image file with the following command:

$ docker load –i innowayit-fe.tar 

3. Start front-end container with following command. Replace parameters in <> with actual values:

$ docker run --name innowayit-fe -d -p 80:80 
--env BACKEND_API_URL="<Backend ip>:3000" 
--env ENVIRONMENT=<deployment environment> innowayit-fe:<front end version x.y.z>

Notes

1. BACKEND_API_URL should the network address of server e.g. http://hostname.domain.com

Verification

1. Run following command:

$ docker ps

It will return the list of two running containers

2. Start Chrome web browser and enter the frontend(innowayit-fe) container’s ip address or domain address (e.g. innowayit.com.rid or 127.0.0.1). The login page should popup