Build with Docker · WaveMaker Docs

WaveMaker supports micro-service enabled architecture. This allows you to build and deploy applications using a container-based technology. Docker is a platform as a service that uses virtualization to deliver software in packages called containers. Containers are isolated from one another and bundle their own software, libraries, and configuration files.

For creating a Docker container, you create a Docker image by building a Dockerfile. For this, you require node and npm as prerequisites for building an application with maven and java.

System prerequisites

Description	Version
Java	1.8
Node	10.15.0
Maven	3.6.3
npm	6.4.1
Ant	1.10.7

How to Build with Docker

Export the project to your local or you can directly clone from a repository. You should keep the Dockerfile in the root directory of the project.

Creating a Dockerfile

To create a Dockerfile, use the following command.

vi Dockerfile

You can use the following Dockerfile for building Docker image and create Docker containers by using multi-stage Dockerfile. You can decrease the size of the Docker image and can create light-weight containers as well.

FROM maven:3.6.3-jdk-8 as maven-java-node
ENV MAVEN_CONFIG=~/.m2
RUN mkdir -p /usr/local/content/node
WORKDIR /usr/local/content/node
ADD https://nodejs.org/dist/v10.15.0/node-v10.15.0-linux-x64.tar.gz .
RUN tar -xzf node-v10.15.0-linux-x64.tar.gz \
    && ln -s /usr/local/content/node/node-v10.15.0-linux-x64/bin/node /usr/local/bin/node \
    && ln -s /usr/local/content/node/node-v10.15.0-linux-x64/bin/npm /usr/local/bin/npm \
    && chown -R root:root /usr/local/content/node \
    && rm -fR node-v10.15.0-linux-x64.tar.gz

FROM maven-java-node as webapp-artifact
RUN mkdir -p /usr/local/content/app
ADD ./ /usr/local/content/app
WORKDIR /usr/local/content/app
ARG build_profile_name
ENV profile=${build_profile_name}
RUN  mvn clean install -P${profile}

FROM tomcat:8.5.50
COPY --from=webapp-artifact /usr/local/content/app/target/*.war /usr/local/tomcat/webapps/
RUN apt-get update && apt-get install vim -y

Save the file to the project's home directory. The Docker automatically picks up the file.

Building Docker Image

Build a Docker image by using the below Docker command with different build profiles. You can choose to build with the following build profiles including development and deployment.

docker image build --build-arg build_profile_name=<deployment-profile> -t <imagename:1.0>

For more information, see Development Profile and Deployment Profile.

Check Handling Build Failures if build failed.

Creating Docker Container

For creating a Docker container, use the below Docker command.

note

You can provide any host_port. For example, 80. Internal port of the container is fixed and not changeable.

docker container run --name <containername> -d -p 80:8080 <imagename:1.0>

You can access the application with <IPaddress:host_port>. For example, 127.1.0.0:80.