docker-deployment

🐳 Docker & Production Deployment Guide

Container Architecture

Service Overview

The POS system uses a multi-container architecture defined in docker-compose.yml:

1. postgres - PostgreSQL database with persistent storage
2. backend - Golang API server with database connectivity
3. frontend - React application served via Nginx

Container Networking

All services communicate through the pos-network bridge network:

• Frontend → Backend: HTTP API calls
• Backend → Database: PostgreSQL connection
• External access via exposed ports

Development vs Production

Development Configuration

Use docker-compose.dev.yml for development:

docker-compose -f docker-compose.dev.yml up

Development Features:

• Volume mounts for live code reloading
• Development-specific environment variables
• Hot reloading for both frontend (Vite) and backend (Air)
• Debug logging enabled

Production Configuration

Use docker-compose.yml for production:

docker-compose up -d

Production Features:

• Optimized multi-stage builds
• Minimal runtime containers (Alpine-based)
• Health checks and restart policies
• Production-ready Nginx configuration

Dockerfile Patterns

Backend Dockerfile

Multi-stage build pattern in backend/Dockerfile:

# Build stage - full Go toolchain
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o main .

# Production stage - minimal runtime
FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/main .
EXPOSE 8080
CMD ["./main"]

Frontend Dockerfile

Node.js build with Nginx serving in frontend/Dockerfile:

# Build stage
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

# Production stage - Nginx
FROM nginx:alpine AS production
COPY nginx.conf /etc/nginx/nginx.conf
COPY --from=builder /app/dist /usr/share/nginx/html
EXPOSE 3000
CMD ["nginx", "-g", "daemon off;"]