Simple Microservices Todo App

This project consists of two separate microservices: a backend and a frontend.

Project Structure

• backend/: Node.js Express API.
• frontend/: Node.js Express server serving static HTML.

How to Separate into Two Repositories

If you want to host these on separate GitHub repositories:

1. Backend Repository:

   cd backend
   git init
   git add .
   git commit -m "Initial commit for backend"
   # Create a new repo on GitHub and follow their instructions to push
   

2. Frontend Repository:

   cd frontend
   git init
   git add .
   git commit -m "Initial commit for frontend"
   # Create a new repo on GitHub and follow their instructions to push
   

Local Development (Monorepo mode)

To run both services together from this root directory:

1. Install root dependencies: npm install
2. Install sub-service dependencies: npm run install:all
3. Start both: npm start

CI/CD with Jenkins, Harbor & Kubernetes

The Jenkinsfile in each microservice is now fully integrated with Kubernetes:

1. Build & Push: Builds the Docker image and pushes it to Harbor.
2. Dynamic Deployment: Uses sed to inject the unique build image tag into the microservice-specific Kubernetes manifest.
3. K8s Rollout: Executes kubectl apply and waits for a successful rollout status.

Pipeline Configuration:

• Ensure kubectl is installed and configured on your Jenkins agent.
• Update the HARBOR_* and K8S_CREDENTIALS_ID variables in each Jenkinsfile.
• Each microservice uses its own k8s-deployment.yaml file.

Kubernetes Deployment (Manual)

Each microservice contains its own Kubernetes manifest for complete independence:

• backend/k8s-deployment.yaml
• frontend/k8s-deployment.yaml

1. Update Manifests

• In backend/k8s-deployment.yaml, update the image field with your actual Harbor image path (or leave as IMAGE_PATH_PLACEHOLDER if using Jenkins).
• In frontend/k8s-deployment.yaml:
  • Update the image field with your Harbor image path.
  • Update the BACKEND_URL in the ConfigMap section to point to your backend service's accessible IP/URL (e.g., your Node IP and the 30001 NodePort).

2. Deploy

Run the following commands:

kubectl apply -f backend/k8s-deployment.yaml
kubectl apply -f frontend/k8s-deployment.yaml

3. Verify

kubectl get pods
kubectl get services

The services are configured as NodePort:

• Frontend: Port 30000
• Backend: Port 30001

Using Docker Compose

Alternatively, run everything using Docker:

docker-compose up --build