riteshatri/resource-management-frontend repository overview

⁠🚀 Resource Management Frontend (Nginx + Docker)

A production-ready, reusable frontend Docker image for the Resource Management application.

This image is designed to be generic and environment-agnostic:

• ❌ No hard‑coded backend IPs
• ✅ Backend configured at runtime using environment variables
• ✅ Works with Docker, Docker Compose, and Kubernetes

⁠✨ Key Features

• 🔁 Runtime backend configuration (no rebuild required)
• 🐳 Multi-stage build (Node.js → Nginx)
• 🔐 Secure by design (no secrets baked into image)
• ⚙️ ENTRYPOINT + CMD best practices
• 📦 Lightweight Alpine-based image
• ☁️ Cloud & Kubernetes friendly

⁠🧠 How It Works (High Level)

Browser
   ↓
Nginx (Frontend Container)
   ↓  /api/*
Backend API (Any Host / Any Env)

• Frontend is served by Nginx
• All /api/* requests are reverse-proxied to the backend
• Backend host & port are injected at container startup

⁠🐳 Image Information

• Base Image: nginx:1.25-alpine
• Runtime Config: envsubst (from gettext)
• Exposed Port: 80

⁠▶️ Quick Start (Recommended)

⁠1️⃣ Pull Image from Docker Hub

docker pull riteshatri/resource-management-frontend:latest

⁠2️⃣ Run Container (Runtime Backend Configuration)

docker run -d \
  -p 80:80 \
  -e BACKEND_HOST=10.0.0.5 \
  -e BACKEND_PORT=8000 \
  --name frontend \
  riteshatri/resource-management-frontend:latest

🔹 Replace BACKEND_HOST and BACKEND_PORT with your backend details.

⁠🔧 Required Environment Variables

❗ These are required at runtime. Without them, Nginx will not start correctly.

⁠🧪 Health Check

curl http://localhost/health

Expected response:

healthy

⁠🧩 Docker Compose Example

version: "3.9"

services:
  backend:
    image: backend-app
    ports:
      - "8000:8000"

  frontend:
    image: riteshatri/resource-management-frontend:latest
    ports:
      - "80:80"
    environment:
      BACKEND_HOST: backend
      BACKEND_PORT: 8000
    depends_on:
      - backend

Run:

docker compose up -d

⁠☸️ Kubernetes (Concept)

• Use ConfigMap for BACKEND_HOST / BACKEND_PORT
• Inject via env: in Deployment
• Same image works across Dev / UAT / Prod

⁠🔐 Security Notes

• ❌ No credentials inside image
• ❌ No hard-coded IPs or URLs
• ✅ Logs streamed to stdout / stderr
• ✅ Graceful shutdown supported (exec nginx)

⁠🏆 Best Practices Followed

• ENTRYPOINT used for fixed startup flow
• CMD used for runtime behavior
• Config generated at container startup
• Image is reusable & immutable

⁠👨‍💻 Author

Ritesh Sharma
DevOps Engineer | Cloud | Docker | Azure | CI/CD

• 🔗 GitHub: https://github.com/Riteshatri⁠
• 🔗 LinkedIn: https://www.linkedin.com/in/riteshatri⁠

⁠⭐ Support

If this image helped you:

• ⭐ Star the GitHub repository
• 🐳 Pull & use the image
• 🐞 Open issues for improvements

⁠❤️ Built with care for real-world DevOps & Cloud professionals