mern-workshop

Instructions and code to deploy MongoDB, a backend Node.js microservice that connects to it, and a frontend that connects to the backend.

The frontend uses React and is served with nginx.

The backend uses Express and features a /api/todos endpoint with CRUD operations enabled.

MongoDB is deployed with persistence and replicas: this is where todo items are stored.

Tested using the Kubernetes service provided by Docker for Desktop on Mac.

Quickstart for local development

• Start a containerized MongoDB

  podman  run --name mongodb -d -p 27017:27017  mongo:7

• Start the backend service

  cd backend
  npm install
  npm start

• Start the frontend service

  cd ../frontend
  npm install
  npm start

Quickstart for Podman

• podman build -f frontend/Dockerfile -t frontend:v1.0.0 frontend
• podman build -f backend/Dockerfile -t backend:v1.0.0 backend
• podman pull mongo:7
• podman network create mern-workshop
• podman run -d --net mern-workshop --name mern-mongo mongo:7
• podman run -d -p 30555:30555 --net mern-workshop -e MONGO_URL=mern-mongo --name mern-backend backend:v1.0.0
• podman run -p 3001:80 frontend:v1.0.0

Visit the application on localhost:3001

Quickstart for Podman-Compose

You can use podman-compose to quickly deploy multiple services at once.

• Install podman compose https://github.com/containers/podman-compose#installation

• Create a file called docker-compose.yaml at the root of the project and copy copy/paste the following yaml:

version: '3'
services:
  frontend:
    build: ./frontend
    ports:
      - 3001:80
    links:
      - backend
  backend:
    build: ./backend
    ports:
      - 30555:30555
    environment:
      - MONGO_URL=mongo
    links:
      - mongo
  mongo:
    image: mongo
    restart: always
    ports:
      - 27017:27017

• Run podman-compose up to deploy the services.

Quickstart for Kubernetes

Requires building the images first, see the quickstart for Docker section.

• Set your Kubernetes context so you're pointing to a Kubernetes environment.
• helm repo add bitnami https://charts.bitnami.com/bitnami
• helm install mongo --set auth.enabled=false,replicaSet.enabled=true,service.type=LoadBalancer,replicaSet.replicas.secondary=3 bitnami/mongodb
• helm install backend backend/chart/backend
• helm install frontend frontend/chart/frontend