Info general Hazedawn

Posted on Apr 8, 2025

🧱 Building a Microservices Architecture with Kubernetes and Docker

Microservices have become the go-to architecture for building scalable and maintainable applications. In this blog, we’ll walk through how to containerize multiple services with Docker, and manage them using Kubernetes.

If you’re new to this, no worries! By the end, you’ll know how to:
✅ Break an app into microservices

✅ Dockerize each service

✅ Deploy and scale them with Kubernetes

Let’s dive in! 🚀

⚙️ What Are Microservices?

Microservices break your app into independent services that can be developed, deployed, and scaled individually.

For example:

🧾 auth-service (handles authentication)
🛒 cart-service (handles shopping cart)
📦 order-service (handles orders)

🐳 Step 1: Dockerizing a Microservice

Let’s start with a simple Node.js Auth Service.

// auth-service/index.js
const express = require('express');
const app = express();
app.get('/auth', (req, res) => res.send('Auth Service Running'));
app.listen(3000, () => console.log('Auth Service on 3000'));

Dockerfile:

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

Then build and run:

docker build -t auth-service .
docker run -p 3000:3000 auth-service

Repeat this pattern for cart-service, order-service, etc.

📦 Step 2: Create Kubernetes Deployments

Let’s define a deployment for auth-service:

# k8s/auth-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: auth-service
spec:
  replicas: 2
  selector:
    matchLabels:
      app: auth
  template:
    metadata:
      labels:
        app: auth
    spec:
      containers:
      - name: auth
        image: yourdockerhub/auth-service
        ports:
        - containerPort: 3000

Expose it with a service:

# k8s/auth-service.yaml
apiVersion: v1
kind: Service
metadata:
  name: auth-service
spec:
  selector:
    app: auth
  ports:
    - protocol: TCP
      port: 80
      targetPort: 3000
  type: ClusterIP

Apply it:

kubectl apply -f k8s/auth-deployment.yaml
kubectl apply -f k8s/auth-service.yaml

Do the same for other microservices.

🔁 Step 3: Add Ingress Controller (Optional but 🔥)

Want to access your services with URLs like /auth, /cart, etc.? Set up an Ingress Controller like NGINX and define routes:

# k8s/ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: microservices-ingress
spec:
  rules:
  - http:
      paths:
      - path: /auth
        pathType: Prefix
        backend:
          service:
            name: auth-service
            port:
              number: 80

🛠️ Tools You’ll Need

🐳 Docker
☸️ Kubernetes (use Minikube or Docker Desktop for local dev)
🔀 kubectl
🧭 Optional: Helm, Skaffold for more advanced setups

🎯 Tips for Real Projects

Use a service mesh like Istio or Linkerd for monitoring and traffic control.
Secure APIs with JWT or OAuth.
Use centralized logging (like ELK) and metrics (like Prometheus/Grafana).

💡 Final Thoughts

Microservices with Docker + Kubernetes = Power combo 💥

It gives you agility, scalability, and resilience.

Start small. Dockerize your services. Set up your k8s cluster. Watch the magic happen. 🔮

🔗 Useful Links

💬 Have questions or want a full GitHub repo of this setup?

Let me know in the comments or drop a ❤️ if you found this helpful!

#Docker #Kubernetes #Microservices #DevOps #WebDev #CloudNative #NodeJS #Backend #Containers #Infrastructure #devto #Hazedawn

Let me know if you’d like a downloadable starter template repo for this guide — I can set that up too!

DEV Community