JOURNAL

Complete Guide to Building Microservices with Node.js and Docker

Master the art of building scalable microservices architecture using Node.js and Docker. This comprehensive guide covers everything from design patterns to production deployment.

Introduction to Microservices Architecture

Microservices architecture has revolutionized how we build and deploy modern applications. Instead of monolithic applications, we break down functionality into smaller, independent services that communicate through well-defined APIs. This guide will walk you through building a complete microservices ecosystem using Node.js and Docker.

Why Microservices?

Before diving into implementation, let's understand the benefits and challenges of microservices:

Aspect	Monolithic	Microservices
Deployment	Single deployment unit	Independent service deployment
Scaling	Scale entire application	Scale individual services
Technology Stack	Single stack	Polyglot architecture
Development	Tight coupling	Loose coupling
Fault Isolation	Single point of failure	Isolated failures

Project Structure

A well-organized microservices project follows this structure:

// auth-service/src/index.js const express = require('express'); const jwt = require('jsonwebtoken'); const bcrypt = require('bcryptjs'); const helmet = require('helmet'); const cors = require('cors'); const app = express(); const PORT = process.env.PORT || 3001; const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key'; // Middleware app.use(helmet()); app.use(cors()); app.use(express.json()); // In-memory user store (use database in production) const users = new Map(); // Health check endpoint app.get('/health', (req, res) => { res.json({ status: 'healthy', service: 'auth-service' }); }); // Register endpoint app.post('/api/auth/register', async (req, res) => { try { const { username, email, password } = req.body; // Validation if (!username || !email || !password) { return res.status(400).json({ error: 'Missing required fields' }); } // Check if user exists if (users.has(email)) { return res.status(409).json({ error: 'User already exists' }); } // Hash password const hashedPassword = await bcrypt.hash(password, 10); // Store user const user = { id: Date.now().toString(), username, email, password: hashedPassword, createdAt: new Date() }; users.set(email, user); // Generate token const token = jwt.sign( { id: user.id, email: user.email }, JWT_SECRET, { expiresIn: '24h' } ); res.status(201).json({ message: 'User registered successfully', token, user: { id: user.id, username: user.username, email: user.email } }); } catch (error) { console.error('Registration error:', error); res.status(500).json({ error: 'Internal server error' }); } }); // Login endpoint app.post('/api/auth/login', async (req, res) => { try { const { email, password } = req.body; // Validation if (!email || !password) { return res.status(400).json({ error: 'Missing credentials' }); } // Find user const user = users.get(email); if (!user) { return res.status(401).json({ error: 'Invalid credentials' }); } // Verify password const isValid = await bcrypt.compare(password, user.password); if (!isValid) { return res.status(401).json({ error: 'Invalid credentials' }); } // Generate token const token = jwt.sign( { id: user.id, email: user.email }, JWT_SECRET, { expiresIn: '24h' } ); res.json({ message: 'Login successful', token, user: { id: user.id, username: user.username, email: user.email } }); } catch (error) { console.error('Login error:', error); res.status(500).json({ error: 'Internal server error' }); } }); // Verify token endpoint app.post('/api/auth/verify', (req, res) => { try { const token = req.headers.authorization?.split(' ')[1]; if (!token) { return res.status(401).json({ error: 'No token provided' }); } const decoded = jwt.verify(token, JWT_SECRET); res.json({ valid: true, user: decoded }); } catch (error) { res.status(401).json({ valid: false, error: 'Invalid token' }); } }); app.listen(PORT, () => { console.log(`Auth service running on port ${PORT}`); });

Tool	Purpose	Integration
Winston	Structured logging	npm install winston
Prometheus	Metrics collection	prom-client library
Grafana	Visualization	Docker container
Jaeger	Distributed tracing	OpenTelemetry

Complete Guide to Building Microservices with Node.js and Docker

Introduction to Microservices Architecture

Why Microservices?

Project Structure

COMMENTS

Building the Authentication Service

Setting Up the Project

Authentication Service Code

Dockerfile for Auth Service

Building the User Service

API Gateway with Express

Docker Compose Configuration

Running the Microservices

Testing the Microservices

Monitoring and Logging

Best Practices

Scaling Strategies

Conclusion