Skip to content

Maskwise v1.2.0 - Production-Ready with Container Networking Fixes

Latest
Latest

Choose a tag to compare

View all tags
@gorkem-bwl gorkem-bwl released this 28 Aug 14:36
· 70 commits to main since this release
v1.2.0
e510769

Maskwise v1.2.0 - Production-Ready with Container Networking Fixes

🚀 Major Updates

✅ Container Database Connection Issue Fixed

  • Resolved P1001 Error: Fixed "Can't reach database server at localhost:5436" error
  • Container Networking: Updated environment configurations to use proper Docker container names
  • Dual Configuration: Support for both Docker Compose and local development setups
  • Environment Separation: Clear .env.development and .env.production templates

✅ CI/CD Docker Build Issues Fixed

  • Fixed Invalid Tag Format: Resolved Docker image tag generation errors in GitHub Actions
  • Build Pipeline: Fixed tag format issues that prevented image generation
  • Release Automation: Corrected workflow configuration for proper release builds

🏭 Complete Production Deployment System

  • One-Command Setup: Automated production deployment with sudo ./deployment/deploy-production.sh
  • Production Docker Compose: Full stack with nginx reverse proxy and SSL/TLS ready
  • Systemd Integration: Auto-restart service with proper security and logging
  • Enterprise Security: Security headers, rate limiting, and production hardening

🛠️ Production Features

Infrastructure & Deployment

  • Automated Deployment Script: Complete server setup and configuration
  • Nginx Reverse Proxy: SSL/TLS ready (disabled by default), security headers, rate limiting
  • Systemd Service Management: Auto-restart, logging, security restrictions
  • Volume Persistence: Database and file storage survives container restarts
  • Health Checks: Proper service dependency management and health monitoring

Security Enhancements

  • SSL/TLS Ready: nginx configured for Let's Encrypt or custom certificates
  • Security Hardening: Non-root users, proper file permissions, security headers
  • Rate Limiting: API and authentication endpoint protection
  • Environment Security: Secure password requirements and JWT secret generation

🔧 Technical Improvements

Container Networking Fixes

# OLD (causing P1001 errors):
DATABASE_URL=postgresql://maskwise:password@localhost:5436/maskwise

# NEW (fixed):
DATABASE_URL=postgresql://maskwise:password@postgres:5432/maskwise

Service URL Updates

Service Docker Compose Local Development
Database postgres:5432 localhost:5436
Redis redis:6379 localhost:6379
Presidio Analyzer presidio-analyzer:3000 localhost:5003
Presidio Anonymizer presidio-anonymizer:3000 localhost:5004

📚 Documentation & Guides

New Documentation

  • PRODUCTION_DEPLOYMENT.md: Comprehensive production deployment guide
  • DEPLOYMENT_README.md: Quick start guide for all deployment scenarios
  • SSL/TLS Setup: Let's Encrypt and custom certificate instructions
  • Troubleshooting Guide: Common issues and solutions

Deployment Options

  1. Quick Development: docker-compose up -d (networking issues fixed)
  2. Production Setup: sudo ./deployment/deploy-production.sh (automated)
  3. Local Development: Individual service startup with localhost URLs

🐛 Bug Fixes

CI/CD Pipeline

  • Fixed Docker image tag generation with invalid format (e.g., -4d98896)
  • Resolved duplicate tag entries in workflow configuration
  • Corrected SHA prefix format for proper image tagging

Database Connection

  • Fixed Prisma P1001 connection errors in Docker containers
  • Proper container networking configuration
  • Health check dependencies to ensure startup order

Environment Configuration

  • Clear separation between development and production environments
  • Secure defaults for production deployment
  • Dual configuration support (Docker vs localhost)

📋 System Requirements

Minimum Requirements

  • OS: Ubuntu 22.04 LTS (recommended) or CentOS 8+
  • RAM: 8GB minimum, 16GB+ recommended
  • CPU: 4 cores minimum, 8+ cores recommended
  • Disk: 50GB free space minimum
  • Docker: Version 24.0+, Docker Compose 2.0+

🚀 Quick Start

Development (Fixed Networking)

git clone https://github.com/bluewave-labs/maskwise.git
cd maskwise
docker-compose up -d
# Access: http://localhost:3000

Production Deployment

git clone https://github.com/bluewave-labs/maskwise.git
cd maskwise
sudo ./deployment/deploy-production.sh
# Follow prompts to configure environment

Docker Images Available

  • ghcr.io/bluewave-labs/maskwise-api:1.2.0
  • ghcr.io/bluewave-labs/maskwise-worker:1.2.0
  • ghcr.io/bluewave-labs/maskwise-web:1.2.0

Access Information

🔍 What's Fixed

User-Reported Issues

  • ✅ Database Connection Error: P1001 "Can't reach database server" resolved
  • ✅ Docker Build Failures: CI/CD pipeline image generation fixed
  • ✅ Container Networking: Proper service discovery between containers
  • ✅ Production Readiness: Enterprise deployment capabilities added

Important Notes:

  • This release fixes both the container database connection issue and CI/CD build failures
  • Production deployment is now fully automated and enterprise-ready
  • Docker images are now properly generated and available on GitHub Container Registry

Full Changelog: v1.1.1...v1.2.0

For technical support, please visit our GitHub Issues page.

Assets 2
Loading