🚀 Django DevOps Project – CI/CD Pipeline on AWS

📌 Project Overview

This project demonstrates a production-ready DevOps workflow for a Django web application using Docker, Jenkins CI/CD, and AWS EC2. The application is containerized and deployed using Docker Compose, with an automated CI/CD pipeline that handles build, test, and deployment.

Goal: To showcase real-world DevOps practices including containerization, CI/CD automation, cloud deployment, and infrastructure reliability.

---

🏗 Architecture Overview

Developer → GitHub → Jenkins CI/CD → Docker Build
                                 ↓
                           AWS EC2 Instance
                         (Docker + Compose)
                                 ↓
                      Django App + PostgreSQL

---

⚙️ Tech Stack

Category	Technology
Backend	Django (Python)
Database	PostgreSQL
Containerization	Docker, Docker Compose
CI/CD	Jenkins
Cloud	AWS EC2
OS	Ubuntu Linux
Version Control	Git & GitHub

---

🔁 CI/CD Pipeline (Jenkins)

The Jenkins pipeline is triggered automatically on every code push to the main branch.

Pipeline Stages:

1. Code Checkout – Pull latest code from GitHub
2. Build Docker Images – Build Django & PostgreSQL containers
3. Run Tests – Execute Django unit tests inside containers
4. Push Changes – Update Docker images
5. Deploy to AWS EC2 – Restart containers using Docker Compose

Key Benefits:

• Zero manual deployment
• Faster release cycles
• Reduced human error
• Production-like CI/CD workflow

---

🐳 Docker & Containerization

• Django backend runs inside a Docker container
• PostgreSQL runs as a separate container
• Docker Compose manages multi-container orchestration
• Environment variables handled via .env file

Services:

• web – Django application
• db – PostgreSQL database

---

☁️ AWS Infrastructure

• EC2 Instance (Ubuntu)

• Security Groups configured for:

  • SSH (22)
  • HTTP (80)

• Docker & Docker Compose installed on EC2

• Jenkins hosted locally / separate server

---

🔐 Security Best Practices

• Environment variables stored securely
• .env file excluded using .gitignore
• Database credentials not hardcoded
• SSH key-based EC2 access
• Jenkins credentials managed securely

---

▶️ How to Run Locally

git clone https://github.com/your-username/project-name.git
cd project-name
docker-compose up --build

Access the application:

http://localhost:8000

---

📈 Future Improvements

• Add Kubernetes (EKS) deployment
• Implement Terraform for IaC
• Enable HTTPS using Nginx & SSL
• Add monitoring (Prometheus + Grafana)
• Blue-Green deployment strategy

---

High-Level Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        Client Layer                             │
│  (Browsers, Mobile)                                             │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ↓ HTTP/HTTPS
┌─────────────────────────────────────────────────────────────────┐
│                    AWS EC2 Instance                             │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │              Nginx Reverse Proxy                          │  │
│  │  • SSL/TLS Termination                                    │  │
│  │  • Load Balancing                                         │  │
│  │  • Static/Media File Serving                              │  │
│  │  • Compression (Gzip)                                     │  │
│  └───────────┬───────────────────────────────────┬────────── ┘  │
│              │                                   │              │
│              ↓ http://web:8000                   ↓              │
│  ┌──────────────────────┐        ┌──────────────────────┐       │
│  │ Django Application   │        │ Static Files Volume  │       │
│  │ (Gunicorn WSGI)      │        │ /vol/web/static      │       │
│  │ • Blog Management    │        └──────────────────────┘       │
│  │ • User Auth          │                                       │
│  │ • Admin Panel        │        ┌──────────────────────┐       │
│  │                      │        │ Media Files Volume   │       │
│  │                      │        │ /vol/web/media       │       │
│  └──────────┬───────────┘        └──────────────────────┘       │
│             │                                                   │
│             ↓ psycopg2 tcp://db:5432                            │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │         PostgreSQL Database                              │   │
│  │  • User Data                                             │   │
│  │  • Blog Posts                                            │   │
│  │  • Categories                                            │   │
│  │  • Media Metadata                                        │   │
│  │  (Persistent Storage: postgres_data volume)              │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
│              ↑ Jenkins CI/CD Deployment                         │
└─────────────────────────────────────────────────────────────────┘

Backend Stack

┌─────────────────────────────────────────┐
│     Application Layer                   │
├─────────────────────────────────────────┤
│ Django 5.0.6                            │
│  • URL Routing (urls.py)                │
│  • Views (views.py)                     │
│  • Models (models.py)                   │
│  • Forms (forms.py)                     │
│  • Admin Interface (admin.py)           │
│  • Middleware Stack                     │
│  • Template Engine                      │
└─────────────────────────────────────────┘
           ↓
┌─────────────────────────────────────────┐
│     WSGI Application Server             │
├─────────────────────────────────────────┤
│ Gunicorn 25.0.3                         │
│  • Worker Pool (sync workers)           │
│  • Request Threading                    │
│  • Graceful Shutdown                    │
│  • Bind: 0.0.0.0:8000                   │
└─────────────────────────────────────────┘
           ↓
┌─────────────────────────────────────────┐
│     Database Layer                      │
├─────────────────────────────────────────┤
│ PostgreSQL 15                           │
│  • Psycopg2 Adapter                     │
│  • Connection Pooling                   │
│  • Transactions Support                 │
│  • ACID Compliance                      │
└─────────────────────────────────────────┘

Infrastructure Stack

┌──────────────────────────────┐
│ Container Orchestration      │
├──────────────────────────────┤
│ Docker-Compose               │
│  • Service Definition        │
│  • Network Configuration     │
│  • Volume Management         │
│  • Environment Setup         │
└──────────────────────────────┘
           ↓
┌──────────────────────────────┐
│ Containerization             │
├──────────────────────────────┤
│ Docker                       │
│  • Image Building            │
│  • Container Management      │
│  • Networking                │
│  • Storage                   │
└──────────────────────────────┘
           ↓
┌──────────────────────────────┐
│ Cloud Infrastructure         │
├──────────────────────────────┤
│ AWS EC2                      │
│  • Compute Instance          │
│  • Security Groups           │
│  • Elastic IPs               │
│  • Storage (EBS)             │
└──────────────────────────────┘

Network Architecture

┌────────────────────────────────────┐
│ Default Docker Network             │
│ (saikrupa_default)                 │
│                                    │
│ ┌──────────┐  ┌──────────┐         │
│ │ postgres │  │  web     │         │
│ │ (db)     │  │ (web)    │         │
│ │ 5432     │  │ 8000     │         │
│ └────┬─────┘  └────┬─────┘         │
│      │             │               │
│      └─────────────┼───────────────┼──┐
│                    │               │  │
│             ┌──────▼────────┐      │  │
│             │   nginx       │      │  │
│             │  80, 443      │      │  │
│             └───────────────┘      │  │
│                                    │  │
└────────────────────────────────────┘  │
                                        │
         ┌──────────────────────────────┘
         │
    ┌────▼────────┐
    │   Host      │
    │ localhost   │
    │ Port 80     │
    └─────────────┘

📖 Full deployment setup: See DEPLOYMENT.md

---

Built with a focus on automation, reliability, and production-grade DevOps practices.