muneebrather/micro-poll repository overview

Micro Poll is a lightweight polling application built to demonstrate Docker Compose orchestration using a four-container architecture. The project showcases container networking, health checks, service dependencies, restart policies, and automatic container recovery.

WHAT IT DOES:

• Vote on DevOps deployment strategies (Rolling Update, Canary, Blue-Green, Recreate)
• Live vote percentage updates
• Displays DevOps tips after voting
• Four-container architecture:
  • Nginx Reverse Proxy
  • Frontend
  • FastAPI (Uvicorn)
  • PostgreSQL

DOCKER CONCEPTS DEMONSTRATED:

• Docker Compose multi-container orchestration
• depends_on with condition: service_healthy
• Health checks for PostgreSQL (pg_isready) and FastAPI (/health)
• Restart policies for automatic container recovery
• Nginx reverse proxy configuration
• Service discovery using Docker networking
• Environment variable configuration
• Persistent PostgreSQL volumes

⁠

ARCHITECTURE:

Browser
  -> Nginx (Port 80)
      -> Frontend
      -> FastAPI (Port 8000)
          -> PostgreSQL (Port 5432)

USAGE:

docker compose up --build

TECH STACK:

• Python 3.11
• FastAPI
• Uvicorn
• PostgreSQL 16
• Nginx
• Docker Compose

⁠

⁠Author

Muneeb Ahmad Rather