
Modern distributed applications increasingly rely on cloud-native platforms to abstract the complexity of deployment and scalability. As the de facto orchestration standard, Kubernetes enables this abstraction, but its declarative configuration model makes the architectural understanding difficult. Developers, operators, and architects struggle to form accurate mental models from raw manifests, Helm charts, or cluster state descriptions. We introduce KubeDiagrams, an open-source tool that transforms Kubernetes manifests into architecture diagrams. By grounding our design in a user-centered study of real-world visualization practices, we identify the specific challenges Kubernetes users face and map these to concrete design requirements. KubeDiagrams integrates seamlessly with standard Kubernetes artifacts, preserves semantic fidelity to core concepts, and supports extensibility and automation. We detail the tool's architecture, visual encoding strategies, and extensibility mechanisms. Three case studies illustrate how KubeDiagrams enhances system comprehension and supports architectural reasoning in distributed cloud-native systems. KubeDiagrams addresses concrete pain points in Kubernetes-based DevOps practices and is valued for its automation, clarity, and low-friction integration into real-world tooling environments.
Software Engineering (cs.SE), FOS: Computer and information sciences, Computer Science - Software Engineering, Software Architecture, KubeDiagrams, Cloud-native, Computer Science - Distributed, Parallel, and Cluster Computing, Kubernetes, Distributed, Parallel, and Cluster Computing (cs.DC), [INFO] Computer Science [cs], Architectural diagrams
Software Engineering (cs.SE), FOS: Computer and information sciences, Computer Science - Software Engineering, Software Architecture, KubeDiagrams, Cloud-native, Computer Science - Distributed, Parallel, and Cluster Computing, Kubernetes, Distributed, Parallel, and Cluster Computing (cs.DC), [INFO] Computer Science [cs], Architectural diagrams
| selected citations These citations are derived from selected sources. This is an alternative to the "Influence" indicator, which also reflects the overall/total impact of an article in the research community at large, based on the underlying citation network (diachronically). | 0 | |
| popularity This indicator reflects the "current" impact/attention (the "hype") of an article in the research community at large, based on the underlying citation network. | Average | |
| influence This indicator reflects the overall/total impact of an article in the research community at large, based on the underlying citation network (diachronically). | Average | |
| impulse This indicator reflects the initial momentum of an article directly after its publication, based on the underlying citation network. | Average |
