Skip to main content
Version: 1.0.0

What is KubeAtlas

KubeAtlas builds a directed dependency graph of every resource in a Kubernetes cluster — Deployments, ConfigMaps, Services, Ingresses, Gateways, HTTPRoutes, PVCs, RBAC, CRDs — and lets you query it. It answers the questions a flat kubectl get view cannot:

  • "If I delete this Secret, what breaks?"
  • "Which Deployments mount this ConfigMap?"
  • "What's the routing path from this Ingress to a Pod?"

What it is not

  • A general-purpose Kubernetes UI. Use Headlamp or Lens for that.
  • A monitoring tool. Use Prometheus, Datadog, or your APM of choice.
  • A GitOps tool. Use Argo CD or Flux.

KubeAtlas is the dependency graph: a focused view that complements the tools above instead of replacing them.

Project status

v1.0.0 — Phase 2 GA. Persistent state (PostgreSQL + Apache AGE, opt-in), programmable Rego rule packs, RBAC graph, blast radius, orphan + cycle detection, /api/v1/* GA endpoints alongside the frozen /api/v1alpha1/* surface, cert-manager TLS Helm integration. Defaults stay the same as v0.1.0: in- memory unless you opt in, single-replica, no built-in authentication — see the security warning before exposing the UI. The Quick Start walks through the install; the Roadmap covers what's next.

Reading order

  1. Quick Start — get a graph out of a cluster (any cluster you control; kind works if you don't have one) in a few minutes.
  2. Architecture — design principles and how the pieces fit together.
  3. Concepts — the conceptual model (blast radius, orphans + cycles, Rego rules, API versioning).
  4. Developer Guide — for contributors: prerequisites, build, test, and a worked example of adding an edge type.
  5. Roadmap — what's next for v1.0.x and v1.1.