KubeDiagrams auto-generates cluster diagrams
- Philippemerle’s KubeDiagrams is gaining attention as a Kubernetes diagramming tool that turns manifests, Helm charts, helmfiles, and live cluster state into architecture maps. - The useful detail is breadth: it handles built-in and custom resources, understands relationships, and exports DOT, draw.io, PDF, PNG, SVG, and more. - Together with newer tools like ctx, it points to a small wave of “ops ergonomics” software that cuts context-switching and stale documentation.
Kubernetes diagrams are usually fake the moment you save them. The cluster changes, Helm values drift, someone adds a controller, and the nice box-and-arrow picture in the wiki is suddenly historical fiction. That is why KubeDiagrams is getting traction right now — it promises to generate the diagram from the actual Kubernetes inputs engineers already use, or from the live cluster itself. (github.com) ### What is KubeDiagrams actually doing? KubeDiagrams is an open-source tool that reads Kubernetes manifest files, kustomization files, Helm charts, helmfile descriptors, or actual cluster state, then turns that into an architecture diagram. That sounds simple, but it fixes a very old problem: infra teams rarely skip diagrams because they hate diagrams. They skip them because keeping them current is tedious and mostly manual. (([github.com)### Why is that harder than it sounds? A Kubernetes app is not one object. It is Deployments, Services, Ingresses, ConfigMaps, Secrets, CRDs, operators, and whatever custom resources your platform team invented last quarter. Most diagram tools do fine on the obvious built-ins, then fall apart once the cluster gets opinionated. KubeDiagrams’ real pitch is that it supports most built-in resources, any custom resources, customizabl(github.com)he difference between a toy picture and something an SRE could actually use. (github.com) ### What comes out the other end? A lot more than a screenshot. KubeDiagrams can export DOT, draw.io, GIF, JPEG, PDF, PNG, SVG, and TIFF, and it also has an interactive viewer plus a web app. The draw.io export matters more than it first appears — teams often want auto-generated structure, then a little manual cleanup for docs or architecture reviews. Editable output makes that workflow possible instead of forcing an all-or-nothing choice between automation and polish. (github.com) ### Why are infra engineers noticing this now? Because the pain has shifted from provisioning to comprehension. Spinning up clusters is easier than it used to be. Understanding what is running across them is not. Modern platform teams juggle GitOps repos, Helm overlays, managed Kubernetes, internal operators, and multiple environments. A tool that can look at source config or live state and render the dependency picture is basically a visibility tool disguised as a diagrammer. (github.com) ### Where does ctx fit into this? ctx is a separate open-source CLI, but it lives in the same “reduce operator friction” category. It lets people switch between AWS profiles, Kubernetes clusters, VPN connections, and SSH tunnels with one command. That is not diagramming — it is context management. But the theme is the same: less manual glue work, fewer chances to point tools at the wrong account or cluster, and less mental overhead every time you move between environments. (github.com) ### And what about the ex-Google mapping repo? That one is even more indirect, but still relevant. The xg2xg project is basically a lookup table for ex-Googlers trying to map internal Google tools and services to outside-world equivalents. It is popular because infrastructure work is full of translation problems — between clouds, between companies, and between mental models. KubeDiagrams helps with visual translation inside a cluster. xg2xg hel(github.com)ems. (github.com) ### Is this a big product launch? Not really — this is more of a tooling moment than a corporate event. KubeDiagrams is already a live GitHub project with thousands of stars and active updates, not a stealth teaser. The interesting part is that small, sharp tools like this are getting shared because infra teams are hungry for anything that removes invisible toil. (github.com) ### So what is (github.com) another Kubernetes visualizer.” The story is that ops tooling is getting more ergonomic. KubeDiagrams turns cluster reality into diagrams without the usual manual redraw loop, and tools around it are attacking the other tiny frictions that eat an engineer’s day. In infrastructure, that kind of boring-sounding improvement compounds fast.