Open-source Kubernetes-native platform for CI/CD, GitOps, and Cluster Management

Documentation · Report Bug · Request Feature

---

Overview

Krustron is a comprehensive Kubernetes-native platform that unifies cluster management, CI/CD pipelines, GitOps workflows, and observability into a single, powerful dashboard. Built for modern DevOps teams who need to manage multiple clusters at scale.

Feature	Description
Multi-Cluster	Manage 50+ Kubernetes clusters from a single pane of glass
GitOps	Native ArgoCD integration with auto-sync and self-heal
CI/CD	Visual pipeline builder with DORA metrics tracking
Security	Container scanning with Trivy and OPA policy enforcement
Observability	Integrated metrics, logging, and distributed tracing

Features

Core Platform Unified Dashboard — Real-time resource browser for Nodes, Pods, Deployments, and CRDs Multi-Cluster Management — Single control plane for all your clusters Fine-grained RBAC — Role-based access control with OIDC/SSO integration Real-time WebSocket — Live updates and streaming logs	GitOps & CI/CD Visual Pipeline Builder — Drag-and-drop YAML editor ArgoCD Integration — Native GitOps with automatic sync Canary & Blue/Green — Traffic splitting via Istio/Linkerd DORA Metrics — Deployment frequency, lead time, MTTR
Helm Management Repository Management — Add, sync, and search Helm repos Release Management — Install, upgrade, rollback releases Drift Detection — Alert when cluster state differs History & Rollback — Full release history tracking	Security & Observability Container Scanning — Trivy vulnerability detection Policy Enforcement — OPA policies with pre-deploy validation Metrics & Logging — Prometheus + OpenSearch integration Distributed Tracing — Jaeger/OpenTelemetry support

Multi-cluster topology

CI/CD pipelines

Observability

AI Operations (Coming Soon)

Natural language queries, auto-remediation, and AI-powered cost optimization

Architecture

Quick Start

Prerequisites

Requirement	Version
Go	1.22+
Node.js	18+
Docker	20+
Kubernetes	1.28+
PostgreSQL	14+
Redis	7+

Installation

Local Development

# Clone the repository
git clone https://github.com/anubhavg-icpl/krustron.git
cd krustron

# Install dependencies
make deps

# Run database migrations
make migrate-up

# Start the backend server
make run

# In another terminal, start the dashboard
cd web/dashboard
npm install
npm run dev

Docker Compose

# Build and run all services
docker-compose up -d

# View logs
docker-compose logs -f krustron

Kubernetes (Helm)

# Add the Helm repository
helm repo add krustron https://charts.krustron.io
helm repo update

# Install Krustron
helm install krustron krustron/krustron \
  --namespace krustron \
  --create-namespace \
  --set postgresql.enabled=true \
  --set redis.enabled=true

Configuration

Krustron can be configured via configuration file, environment variables, or CLI flags.

Environment Variables

# Database
export KRUSTRON_DATABASE_PASSWORD=your-password

# Authentication
export KRUSTRON_AUTH_JWT_SECRET=your-jwt-secret

# OIDC (optional)
export KRUSTRON_AUTH_OIDC_CLIENT_SECRET=your-oidc-secret

# ArgoCD (optional)
export KRUSTRON_GITOPS_ARGOCD_AUTH_TOKEN=your-argocd-token

API Reference

Full API documentation available at /swagger/index.html when running the server.

Endpoint	Method	Description
/api/v1/clusters	GET	List all clusters
/api/v1/clusters	POST	Add a new cluster
/api/v1/applications	GET	List GitOps applications
/api/v1/applications/:id/sync	POST	Trigger application sync
/api/v1/helm/releases	GET	List Helm releases
/api/v1/pipelines/:id/trigger	POST	Trigger pipeline
/api/v1/security/scans	GET	List security scans

Project Structure

krustron/
├── cmd/krustron/           # Main entry point
├── api/
│   ├── handlers/           # HTTP handlers
│   ├── middleware/         # HTTP middleware
│   └── router/             # Route definitions
├── internal/
│   ├── cluster/            # Cluster management
│   ├── helm/               # Helm operations
│   ├── gitops/             # GitOps (ArgoCD)
│   ├── pipeline/           # CI/CD pipelines
│   ├── auth/               # Authentication & RBAC
│   ├── security/           # Security scanning
│   └── observability/      # Metrics, logs, traces
├── pkg/
│   ├── kube/               # Kubernetes client
│   ├── logger/             # Logging
│   ├── config/             # Configuration
│   ├── websocket/          # WebSocket server
│   └── cache/              # Redis cache
├── web/dashboard/          # React dashboard
├── charts/krustron/        # Helm chart
└── assets/                 # Logo and images

Roadmap

Phase 1: MVP Dashboard Resource browser Helm app management Basic RBAC Multi-cluster support Real-time WebSocket

Phase 2: CI/CD & GitOps Visual pipeline builder ArgoCD integration Canary deployments DORA metrics

Phase 3: Enterprise AI operations (LLM) Cost management Auto-remediation 100+ integrations

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

# Fork the repository
# Create your feature branch
git checkout -b feature/amazing-feature

# Commit your changes
git commit -m 'Add amazing feature'

# Push to the branch
git push origin feature/amazing-feature

# Open a Pull Request

Tech Stack

Backend	Frontend	Infrastructure

Support

• Documentation: docs.krustron.io
• Issues: GitHub Issues
• Discussions: GitHub Discussions

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Acknowledgments

Built with Gin, client-go, and ArgoCD

---

Krustron — Kubernetes Platform for Modern DevOps

Made with ❤️ by Anubhav Gain