rmvs / wicm

WICM

WICM stands for Web Interface for Container Management. Its primary goal is to expose a web interface for container management using docker as backend for application service creation. There are other tools known for this kind of task. This is an experimental project that aims to use IaC tools and to cover common aspects of web application development.

You can get an overview here.

Web tier

This project was made using Node.js + Express.js for server side rendering. Webpack bundles all server code (views, styles, and modules) in a single file.

• This app makes uses of Prisma ORM for persiting user data.
• All session data are memory-based.
• Twig.js is used as a template engine

Client tier

Webpack exposes a global variable called "app" that can be acessed throughout the views. It acts as a single point for calling functions in the client side. You can view client code is located here. This projects makes use of TailwindCSS as an utility library for creating richer interfaces.

Cluster orchestration

Docker swarm does all the job in scheduling,updating and removing services. The REST API is responsible for authentication and authorization as well as cluster management through the remote docker daemon socket.

The configuration as described here consists of 3 worker nodes and 1 master.

Routing and Load Balancing

Traefik is used as primary API Gateway to route traffic in addition to load balancing. Docker Swarm offers autoscaling of tasks across the workers.

You can install dependencies using

npm install

To build this project

npm run build

or

yarn build

To run this application:

npm run watch

You need to configure a session secret in the .env file before running this app

SESSION_SECRET=
BASE_URL=
API_URL=
SECRET=

Configure the API_URL as an URL that points to the running project WICM-API.

References

• Protect Docker Daemon Socket
• Swarm Mode Overview
• Configuring Traefik in Swarm Mode
• Scaling Web Apps