This project showcases two independently valuable tools built during my DevOps learning journey:

1. API-First Automated Deployment System: A FastAPI-based server that automates pulling Docker images and deploying them securely via API calls — ideal for development & testing environments.

2. Bot-Web Monitoring Tool: A FastAPI + React.js based container monitoring web app to list, start, stop, and view logs of Docker containers on the host.

Both tools are designed to run on any server infrastructure (cloud, home lab, or on-premises) with secure HTTPS exposure using Cloudflare Tunnel, requiring no SSH or direct server access.

• Trigger Docker image pulls and deployments with a single API call
• GitHub Actions integration for seamless CI/CD
• Secure API authentication with an API key
• Minimal downtime: old containers stopped before starting new ones
• Supports rapid dev/test deployments without manual server access

• List all containers (running & stopped)
• Start and stop containers via UI
• View container logs (on refresh)
• Clean React.js frontend, FastAPI backend
• Secured with Cloudflare Tunnel for HTTPS public access

graph TD
    A[Developer pushes code] --> B[GitHub Actions builds & pushes Docker images]
    B --> C[GitHub Actions triggers FastAPI Deployment Server API]
    C --> D[Deployment Server pulls new images & redeploys containers]
    D --> E[Bot-Web lists and manages containers from browser UI]

Deploy latest frontend & backend images from Docker Hub.

• Header: X-API-KEY: <your-secret-key>

Lists all Docker containers (running & stopped).

• Header: X-API-KEY: <your-secret-key>

• Accessible UI to monitor all containers on the host
• Start/Stop containers directly from your browser
• View logs for troubleshooting (refresh to update)
• Requires no API; interacts directly with the Docker host

• Cloudflare Tunnel protects your server with HTTPS and hides your IP
• No SSH access needed for deployments or monitoring
• API access secured with API keys in .env

Example .env file:

API_KEY=your-secret-api-key
FRONTEND_IMAGE_URL=ashu111/bot-web-frontend:latest
BACKEND_IMAGE_URL=ashu111/bot-web-backend:latest

docker build -t bot-web-server:1 ./server

docker run -v /var/run/docker.sock:/var/run/docker.sock -p 9000:9000 bot-web-server:1

curl -X POST https://<your-domain>/deployee \
     -H "X-API-KEY: your-secret-api-key"

• FastAPI: Deployment server & Bot-Web backend
• React.js + Tailwind CSS: Bot-Web frontend
• Docker: Containerization
• GitHub Actions: CI/CD automation
• Cloudflare Tunnel: Secure public access

• Real-time logs & WebSocket support for Bot-Web
• Add role-based access control (RBAC)
• Improve error handling & observability
• Extend to Kubernetes (optional)

This project is a practical example of how DevOps automation can simplify infrastructure management and save development time. It's ideal for:

• Home lab & self-hosted setups
• Small teams automating dev/test deployments
• Anyone learning secure server automation with Docker & FastAPI

GitHub: https://github.com/ashupal86/bot-web

Created by Ashish Pal