Skip to content

Johannes613/cloud-orchestrator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 

Repository files navigation

Cloud Orchestrator: Kubernetes-Powered App Management Platform

React Badge TypeScript Badge FastAPI Badge Python Badge Kubernetes Badge GitHub Actions Badge Docker Badge

CloudNative Orchestrator is a full-stack cloud-native dashboard for managing Kubernetes applications with GitOps, FastAPI backend, and React + TypeScript frontend. It offers real-time cluster monitoring, deployment metrics, and CI/CD visibility.

🐳 Docker Image: https://hub.docker.com/repository/docker/johannes613/cloudnative-orchestrator

🔄 GitHub Actions CI/CD: Automatically builds and pushes to Docker Hub on every push to main. Workflow file: .github/workflows/docker-build.yml


Live Preview

Frontend: cloudnative-orchestrator.vercel.app

Demo

Demo GIF

The Problem

  • Low visibility: No easy way to see real-time deployment and cluster health across environments.
  • Manual processes: DevOps workflows often lack automation and rollback capability.
  • Complex setup: Managing GitOps manually is error-prone and time-consuming.

This app centralizes deployment visibility, CI/CD automation, and live metrics into one beautiful interface.


Features

1. GitOps Monitoring

  • Track GitHub repositories and deployment history.
  • Show deployment status: success, pending, failed.
  • Average deployment time metrics.

2. Cluster Dashboard

  • Live metrics for pods, nodes, and services.
  • Timeline and rollback for deployments.

3. FastAPI Backend

  • Handles API requests for deployments and metrics.
  • Async endpoints using httpx, pydantic, and uvicorn.

4. CI/CD & Docker Integration

  • GitHub Actions pipeline: auto build → test → Docker push.
  • Images available on Docker Hub.

Tech Stack

LayerTechnologies Used
FrontendReact, TypeScript, Material UI, Lucide Icons
BackendPython, FastAPI, Uvicorn, Pydantic
CI/CDGitHub Actions (Docker Build & Push)
ContainerizationDocker
OrchestrationKubernetes, GitOps Principles
MonitoringSimulated Real-Time Metrics

Getting Started

Frontend Setup

  1. Clone the repo:
    git clone https://github.com/your-username/cloudnative-orchestrator.git
    cd cloudnative-orchestrator/frontend
  2. Install dependencies:
    npm install
  3. Start development server:
    npm run dev

    App will run at http://localhost:3000

Backend Setup (FastAPI)

  1. Navigate to backend folder:
    cd ../backend
  2. Create virtual environment:
    python -m venv venv
    source venv/bin/activate  # on Windows use: venv\Scripts\activate
  3. Install requirements:
    pip install -r requirements.txt
  4. Run FastAPI server:
    uvicorn main:app --reload

    Server will be running at http://localhost:8000

Example File Structure


cloudnative-orchestrator/
├── frontend/         # React + TypeScript + MUI
│   └── ...
├── backend/          # FastAPI
│   ├── main.py
│   ├── models/
│   └── routes/
├── .github/
│   └── workflows/docker-build.yml
  

About

A full-stack cloud-native dashboard for deployment monitoring, Kubernetes metrics, and CI/CD using FastAPI and React

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors