Docker Integration

JAngular provides comprehensive Docker integration with optimized containerization for all application components. The Docker setup includes multi-stage builds, persistent data storage, service orchestration, and production-ready configurations for seamless deployment across environments.

Containerized Architecture

The JAngular Docker setup consists of a complete microservices architecture with the following containerized components:

Core Application Services

• Backend Service - Spring Boot application with Eclipse Temurin JDK 21
• Frontend Service - Angular application served through Nginx with optimized static content delivery
• Reverse Proxy - Nginx-based routing and load balancing for production deployments

Database Services

• MySQL 8.0+ - High-performance relational database with InnoDB storage engine
• PostgreSQL 15+ - Advanced open-source database with JSON support and performance optimizations
• Microsoft SQL Server 2019+ - Enterprise database for Windows-based environments

Database Management Tools

• phpMyAdmin - Web-based MySQL administration interface
• pgAdmin 4 - PostgreSQL administration and development platform
• SQL Server Management Studio (SSMS) - Microsoft SQL Server administration tools

Docker CLI Management

The JAngular CLI provides an interactive Docker management interface for easy container orchestration:

Interactive Docker Menu

jangular docker

This command launches an interactive menu with the following capabilities:

Service Management

• Start All Services - Launch complete application stack with one command
• Stop All Services - Gracefully shutdown all containers
• Start Specific Services - Launch individual components (database, backend, frontend)
• Restart Services - Restart containers with configuration changes

Monitoring & Diagnostics

• View Service Logs - Real-time log streaming for all or specific services
• Check Database Health - Database connectivity and performance checks
• Container Status - Monitor container health and resource usage
• Network Diagnostics - Inter-service communication testing

Data Management

• Reset Volumes - Clean database volumes and reset to initial state
• Backup Data - Create persistent backups of database volumes
• Import/Export - Database migration and seeding utilities

Deployment Options

• Development Mode - Hot reload enabled with debug configurations
• Production Mode - Optimized builds with security hardening
• Testing Mode - Isolated environment for automated testing

Multi-Stage Docker Builds

Optimized Docker builds using multi-stage architecture for minimal image sizes and enhanced security:

Backend Build Configuration

# Stage 1: Build Environment
FROM eclipse-temurin:21-jdk-jammy AS build
WORKDIR /app
COPY pom.xml .
COPY .mvn .mvn
COPY mvnw .
RUN chmod +x mvnw
COPY src ./src
RUN ./mvnw clean package -DskipTests

# Stage 2: Runtime Environment
FROM eclipse-temurin:21-jre-jammy
RUN groupadd -r spring && useradd -r -g spring spring
USER spring:spring
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
EXPOSE 8080

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:8080/actuator/health || exit 1

ENTRYPOINT ["java", "-jar", "app.jar"]

Frontend Build Configuration

# Stage 1: Build Environment
FROM node:20-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production && npm cache clean --force
COPY . .
RUN npm run build --prod

# Stage 2: Web Server
FROM nginx:alpine
RUN addgroup -g 1001 -S nginx && adduser -S nginx -u 1001
COPY --from=build /app/dist/frontend/browser /usr/share/nginx/html
COPY nginx.conf /etc/nginx/nginx.conf
COPY nginx-default.conf /etc/nginx/conf.d/default.conf
EXPOSE 80

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD wget --no-verbose --tries=1 --spider http://localhost/ || exit 1

CMD ["nginx", "-g", "daemon off;"]

Build Optimizations

• Layer Caching - Optimized layer ordering for maximum cache efficiency
• Multi-Architecture - Support for ARM64 and AMD64 architectures
• Security Hardening - Non-root users and minimal attack surface
• Health Checks - Built-in health monitoring for container orchestration

Docker Compose Orchestration

Comprehensive service orchestration with environment-specific configurations:

Development Configuration

# Start development environment
docker-compose up -d

# View aggregated logs
docker-compose logs -f

# View logs for specific service
docker-compose logs -f backend
docker-compose logs -f frontend
docker-compose logs -f mysql

# Stop all services
docker-compose down

# Stop and remove volumes (clean slate)
docker-compose down -v --remove-orphans

Production Configuration

# Deploy production environment
docker-compose -f docker-compose.prod.yml up -d

# Production health check
docker-compose -f docker-compose.prod.yml ps

# Scale services
docker-compose -f docker-compose.prod.yml up -d --scale backend=3

# Production shutdown
docker-compose -f docker-compose.prod.yml down

Service Dependencies

• Startup Order - Database services start before application services
• Health Dependencies - Applications wait for database readiness
• Network Isolation - Services communicate through dedicated Docker networks
• Volume Management - Persistent storage for databases and configuration

Environment Configuration

Flexible configuration management supporting multiple deployment scenarios:

Environment Variables

# Backend Environment
SPRING_PROFILES_ACTIVE=docker
SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/jangular
SPRING_DATASOURCE_USERNAME=jangular_user
SPRING_DATASOURCE_PASSWORD=secure_password
JWT_SECRET=your-production-jwt-secret
CORS_ALLOWED_ORIGINS=http://frontend:80

# Frontend Environment
ANGULAR_ENV=production
API_BASE_URL=http://backend:8080/api
AUTH_BASE_URL=http://backend:8080/auth

# Database Environment
MYSQL_ROOT_PASSWORD=root_password
MYSQL_DATABASE=jangular
MYSQL_USER=jangular_user
MYSQL_PASSWORD=secure_password

Configuration Files

• .env - Development environment variables
• .env.prod - Production environment variables
• .env.test - Testing environment variables
• docker-compose.override.yml - Local development overrides

Security Considerations

• Secret Management - Docker secrets for sensitive configuration
• Environment Isolation - Separate configurations per environment
• Credential Rotation - Support for dynamic credential updates
• Access Control - Network policies and service isolation

Persistent Storage & Volumes

Robust data persistence with backup and recovery capabilities:

Volume Configuration

• Database Volumes - Persistent storage for database files
• Configuration Volumes - Application configuration and secrets
• Log Volumes - Centralized logging and audit trails
• Upload Volumes - User-generated content storage

Backup Strategy

# Database backup
docker-compose exec mysql mysqldump -u root -p jangular > backup.sql

# Volume backup
docker run --rm -v jangular_mysql_data:/data -v $(pwd):/backup \
  alpine tar czf /backup/mysql-backup.tar.gz /data

# Restore from backup
docker run --rm -v jangular_mysql_data:/data -v $(pwd):/backup \
  alpine tar xzf /backup/mysql-backup.tar.gz -C /

Data Management

• Volume Snapshots - Point-in-time backup creation
• Data Migration - Cross-environment data transfer
• Cleanup Procedures - Safe volume removal and cleanup
• Storage Monitoring - Disk usage and performance metrics

Production Deployment

Enterprise-ready deployment with advanced orchestration and monitoring:

Production Features

• SSL/TLS Termination - Automatic certificate management with Let's Encrypt
• Load Balancing - Multi-instance backend scaling with health checks
• Reverse Proxy - Nginx-based traffic routing and caching
• Resource Limits - Memory and CPU constraints for optimal performance
• Health Monitoring - Comprehensive health checks and alerting
• Log Aggregation - Centralized logging with structured output

Production Commands

# Production deployment
docker-compose -f docker-compose.prod.yml up -d

# Scale backend services
docker-compose -f docker-compose.prod.yml up -d --scale backend=3

# Rolling updates
docker-compose -f docker-compose.prod.yml up -d --force-recreate backend

# Monitor production health
docker-compose -f docker-compose.prod.yml ps
docker-compose -f docker-compose.prod.yml top

Monitoring & Observability

• Health Endpoints - Application and database health monitoring
• Metrics Collection - Performance metrics and resource usage
• Log Analysis - Error tracking and performance analysis
• Alerting - Automated notifications for critical issues

Database Integration

Comprehensive database support with administration tools and health monitoring:

Database Health Checks

# MySQL health check
docker-compose exec mysql mysqladmin ping -h localhost -u root -p

# PostgreSQL health check
docker-compose exec postgres pg_isready -U postgres

# SQL Server health check
docker-compose exec mssql /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P password -Q "SELECT @@VERSION"

Database Administration

• Web Interfaces - Browser-based database management
• Migration Tools - Automated schema migration and seeding
• Performance Monitoring - Query analysis and optimization tools
• Backup Automation - Scheduled backup and retention policies

Connection Management

• Connection Pooling - Optimized database connection management
• SSL Encryption - Secure database communications
• Access Control - Role-based database access permissions
• Network Isolation - Database network security and isolation

Production Note: The Docker configuration includes comprehensive security hardening, performance optimization, and monitoring capabilities suitable for enterprise production environments.