Виталий ЧефановandClaude Opus 5.5 8b8fe341d5 v0.7.2: empty traffic window no longer blanks the map
The flows API sent "edges": null for a window without connections (a nil
Go slice); the frontend iterated it and renderMap threw after the new
breadcrumbs were drawn, so the previous namespace stayed on screen under
the new name. The API now sends empty lists, fetchFlows guards against
null, and a failed draw reports itself in the status bar.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 22:18:28 +03:00

cluster-map

A Deckhouse Kubernetes Platform module: an interactive topology map of the cluster with live traffic from Cilium Hubble. User documentation is in docs/README.md (на русском).

The module follows deckhouse/modules-template: werf build, lib-helm templates, module-sdk hooks, and it passes dmt lint with no findings.

Layout

Path What
module.yaml, Chart.yaml, .helmignore, oss.yaml, changelog.yaml module metadata
openapi/ config-values.yaml (ModuleConfig settings), doc-ru-config-values.yaml, values.yaml (internal values)
templates/ Helm templates on lib-helm (charts/deckhouse_lib_helm-*.tgz)
hooks/batch/ Go hooks on module-sdk: hubble CA, external auth, custom certificate
images/cluster-map/ the application image: werf.inc.yaml and the Go source in src/
monitoring/prometheus-rules/ alert rules
docs/ user documentation, English and Russian
.werf/, werf.yaml, werf-giterminism.yaml build, from modules-template
tests/values/ values for make render

The application (images/cluster-map/src)

Package What
cmd/cluster-map wiring, signals, graceful shutdown
internal/config settings from the environment (the Deployment template is the only writer)
internal/kube informer caches, managedFields stripped
internal/topology the graph: workloads, Services, Ingresses, nodes, and the pod-owner rules shared with traffic
internal/traffic Hubble follow stream, per-minute buckets of distinct connections
internal/server HTTP API, CSP headers, request metrics
internal/metrics Prometheus metrics
web/ the frontend, embedded into the binary: plain JS, Cytoscape.js, elkjs, English and Russian

API: /api/graph, /api/flows?namespaces=a,b&window=<seconds>, /api/resource?kind=&namespace=&name=, /api/pods?id=&namespace=, /api/logs?namespace=&pod=&container=, /healthz, /readyz; metrics on :9090/metrics.

Development

make test     # go test -race for the app, hook tests on the module-sdk framework
make lint     # golangci-lint and dmt
make render   # helm template with tests/values/*.yaml

dmt is built from deckhouse/dmt; crane from go-containerregistry.

Build and publish

Base images come from the base_images.yml Deckhouse publishes for its own modules (make base-images; the file is not committed, as in the template).

docker login git.project-chimera.ru
make publish VERSION=v0.7.0              # build, push bundle and release, register, channel alpha
make release VERSION=v0.7.0 CHANNEL=stable

The registry layout matches deckhouse/modules-actions:

<SOURCE>:cluster-map                    module registration (empty image)
<SOURCE>/cluster-map:v0.7.0             bundle
<SOURCE>/cluster-map:<content-tag>      application image
<SOURCE>/cluster-map/release:v0.7.0     release
<SOURCE>/cluster-map/release:<channel>  alpha | beta | early-access | stable | rock-solid

Install

apiVersion: deckhouse.io/v1alpha1
kind: ModuleSource
metadata:
  name: cluster-map
spec:
  registry:
    repo: git.project-chimera.ru/fanchji/cluster-map
    scheme: HTTPS
---
apiVersion: deckhouse.io/v1alpha2
kind: ModuleUpdatePolicy
metadata:
  name: cluster-map
spec:
  releaseChannel: Alpha
  update:
    mode: Auto
---
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: cluster-map
spec:
  enabled: true
  version: 1
  updatePolicy: cluster-map
  source: cluster-map
  settings:
    auth:
      allowedUserGroups: [admins]

The module is Experimental: enable allowExperimentalModules in the deckhouse ModuleConfig first.

License

Apache 2.0, see LICENSE. Go files carry an Apache-2.0 header with a neutral copyright line; DMT's license rule expects Copyright <year> Flant JSC, so .dmtlint.yaml excludes the two Go directories from that rule until the headers are changed on transfer.

S
Description
Interactive Deckhouse cluster topology map -- namespace/workload/service graph with click-through config details, live traffic overlay via Cilium Hubble
Readme Apache-2.0
1.2 MiB
Languages
Go 59.2%
JavaScript 29.1%
Go Template 4.7%
CSS 4%
HTML 1.8%
Other 1.2%