Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 2.85 KB

DockerImageDeployment.md

File metadata and controls

69 lines (52 loc) · 2.85 KB
Raw

How to Build the Docker Image

This document describes how to setup and start a docker image and its container for the JGU WEKA Rest service.

Setup the Dockerfile

The current docker image is build with a simple Dockerfile that uses a tomcat base-image from hub.docker.com/_/tomcat, the official Apache Tomcat repository.
The Dockerfile removes all pre-installed webapps from tomcat and copies the JGU WEKA Rest service war file to /usr/local/tomcat/webapps/ROOT.war as the main application.
Then it installs the SSL certificates from the openam.in-silico.ch Authentication & Authorization server to the tomcat keystore. Finally port 8080 is exposed.

FROM tomcat:8.0-jre8
MAINTAINER "MyName <[email protected]>"

# remove preinstalled webapps 
RUN rm -fr /usr/local/tomcat/webapps/ROOT
RUN rm -fr /usr/local/tomcat/webapps/host-manager
RUN rm -fr /usr/local/tomcat/webapps/manager
RUN rm -fr /usr/local/tomcat/webapps/docs
RUN rm -fr /usr/local/tomcat/webapps/examples

COPY target/weka_rs-<VERSION_NUMBER>.war /usr/local/tomcat/webapps/ROOT.war

# add openam certificat to tomcat's cert-store
RUN openssl s_client -showcerts -connect openam.in-silico.ch:443 </dev/null 2>/dev/null|openssl x509 -outform PEM > /usr/local/tomcat/in-silicoch.crt
RUN keytool -keystore /etc/ssl/certs/java/cacerts -keypass changeit -storepass changeit -noprompt -importcert -alias openam.in-silico.ch -file /usr/local/tomcat/in-silicoch.crt

EXPOSE 8080

Customise the Dockerfile as needed (e.g.: adjust the war file name and version).

Build the Docker Image

  • Download the source code from Github
    git clone [email protected]:jguwekarest/jguwekarest.git
  • Change into code directory
    cd jguwekarest
  • Checkout branch (optional)
    master for OpenAPI 3.0.1, OAS2 for OpenApi 2.0 version
    git checkout master
  • Compile the war (Web Application Archive) file with maven
    mvn clean package
  • Build the docker image (replace dockerhubuser with your docker hub account user)
    docker build -t dockerhubuser/jguweka:OAS3 .
  • Check images
    docker images

Run the Docker Container

  • Run the image as a local container docker run -p 8080:8080 --link mongodb:mongodb dockerhubuser/jguweka:OAS3
  • If you run the container locally don't forget to start also a mongodb container as a data base with:
    docker pull mongo; docker run --name mongodb -d mongo
  • Load the Swagger-UI representation in a web-browser
    e.g.: firefox http://0.0.0.0:8080

Documentation

See also: