Почему kubectl get мне не хватало

Знакомая сцена: в проде что-то не работает, под вчерашний деплой. Поды в CrashLoopBackOff, ReplicaSet не набирает реплик, а в логах - ничего, что объясняло бы, почему.

Дальше начинается работа, которую я делал много раз и которая состоит в основном из перебора одних и тех же вопросов:

kubectl get deploy,rs,pod,svc,ingress -n shop
kubectl describe pod web-6f8d6c8667-2zkbw -n shop
kubectl get events -n shop --sort-by=.lastTimestamp
kubectl get cm,secret -n shop
kubectl rollout history deploy/web -n shop

Всё это правильные команды. Но они показывают список, а не связи. Чтобы понять, что именно сломалось, нужно в голове склеить вывод шести команд в одну картинку: вот этот Pod принадлежит этому ReplicaSet, этот ReplicaSet - этому Deployment, этот Deployment берёт переменные из того ConfigMap, а этот ConfigMap кто-то изменил вчера.

Дашборды (Lens, Headlamp, часть Grafana-плагинов) решают другую половину проблемы - быстрый просмотр, но там объект снова объект, а не узел в графе.

Мне хотелось инструмент, который отвечает на вопрос «почему» прямо: вот этот жёлтый объект, вот причина, вот цепочка объектов, которая к ней ведёт.

Так появился Wiring - настольное приложение, в котором главный экран это граф namespace.

Общий вид: граф слева, навигатор ресурсов, панель деталей снизу
Общий вид: граф слева, навигатор ресурсов, панель деталей снизу

Что это умеет

Граф

Основной вид - живой граф выбранных namespace, собранный из watch’ей Kubernetes. Он не «срисован» один раз и не обновляется по кнопке: приходят события, граф меняется сам.

Граф namespace shop: Ingress shop-web → Service shop-web → Deployment web → ReplicaSet → Pod, рядом HPA, ConfigMap, Secret, ServiceAccount и PVC
Граф namespace shop: Ingress shop-web → Service shop-web → Deployment web → ReplicaSet → Pod, рядом HPA, ConfigMap, Secret, ServiceAccount и PVC

Несколько вещей, ради которых я его и делал:

  • Связи между объектами. Ingress → Service → Deployment → ReplicaSet → Pod, плюс то, что нагрузка использует: ConfigMap, Secret, PVC, ServiceAccount, HPA.

  • Группировка. Поды одного владельца сворачиваются в один узел; двойной клик разворачивает обратно. В namespace на полсотни объектов это спасает от каши.

  • Причина, а не симптом. Если выбрать жёлтый или красный объект, в панели снизу будет не «CrashLoopBackOff», а объяснение: состояние пода, причина от Kubernetes и цепочка до корня - например Deployment → ReplicaSet → Pod → ImagePullBackOff. Эта же цепочка подсвечивается на графе.

  • Фильтры по kind чипами под заголовком и поиск по ⌘K / Ctrl+K.

  • NetworkPolicy, RBAC и Node включаются отдельными чипами: видно, кому политика разрешает трафик, какие роли получает ServiceAccount через какие биндинги и на какой ноде сидит под.

Выбран Deployment web: снизу YAML и кнопка Edit, справа связанные Pod и ReplicaSet
Выбран Deployment web: снизу YAML и кнопка Edit, справа связанные Pod и ReplicaSet

Таблицы, YAML, логи, терминал, порты

Граф - не единственный вид. Тот же объект можно открыть таблицей по kind, посмотреть YAML (и отредактировать его прямо в приложении), почитать события, подключиться к логам, открыть терминал в контейнере и пробросить порт.

Таблица подов: имя, kind, namespace, статус, рестарты, нода, возраст
Таблица подов: имя, kind, namespace, статус, рестарты, нода, возраст

Порты пробрасываются прямо из окна приложения: Wiring подбирает свободный локальный порт, поднимает проброс и даёт ссылку - с кнопкой «скопировать» и списком активных пробросов в шапке.

Навигатор

Слева - список ресурсов по категориям (Workloads, Config, Network, Storage, Access Control, Cluster), у каждого kind живой счётчик и худший статус среди объектов. Счётчик «Pods 16 🔴» честнее, чем просто «Pods 16».

Кластеры и namespace вынесены в шапку, а сам навигатор сворачивается в иконковый рельс:

Свёрнутый навигатор: рельс с маркой, статусом и иконками разделов
Свёрнутый навигатор: рельс с маркой, статусом и иконками разделов

Виды, в которых приложение вам честно говорит «у меня ничего нет», я перечислять не буду - их довольно много, и они важнее, чем кажется: пустой namespace, namespace без прав доступа, поиск без совпадений, слишком много объектов для графа (тогда приложение само переключается на таблицы и говорит об этом).

Как это устроено

Бэкенд — Rust поверх kube-rs: он держит watch’и, строит снапшот графа и шлёт дельты в фронтенд. Фронтенд - React 19 и React Flow, который рисует граф и раскладывает его сам (правила раскладки свои, без dagre).

IPC - обычные Tauri-команды и события; контракт расписан в docs/ipc-contract.md, включая то, какие команды работают без сессии. Всё, что может понадобиться фронтенду, лежит в одном сторе на zustand.

Приложение - одно окно, без веб-сервера и без демона: kubeconfig читается из вашего окружения, состояние живёт в процессе. Логи и терминал идут через stdin/stdout контейнера, а не через API-сервер.

Сборка и публикация - GitHub Actions: фронтенд, бэкенд на трёх ОС, сборщик установщиков и smoke-тест на kind-кластере. Релизы выходят тегами, обновления подписываются отдельным ключом (это подпись обновлений, не подпись приложения).

Как попробовать

Сборки для macOS (universal .dmg) и Windows (.msi и -setup.exe) лежат в Releases. Linux - сборка из исходников, готового установщика с брендом нет.

macOS без подписи Developer ID: при первом запуске Gatekeeper спросит, доверять ли приложению. Это ожидаемо для неподписанной сборки, не битая загрузка. Проще всего правый клик по Wiring.app → Открыть; можно снять метку карантина:

xattr -dr com.apple.quarantine /Applications/Wiring.app

Windows: SmartScreen предупредит о неизвестном издателе - More info → Run anyway.

Если хочется посмотреть на живые данные, а не на свой прод, в репозитории есть скрипт, который разворачивает демо-кластер локально:

examples/demo/setup.sh                 # контекст docker-desktop
examples/demo/setup.sh kind-kind       # или другой контекст
examples/demo/setup.sh --with-metrics  # плюс metrics-server, если нужны CPU и Memory

Он создаёт два namespace, shop и blog, с намеренно сломанными нагрузками (образ, который не тянется, и контейнер, который падает на старте) и две RBAC-роли, wiring-viewer и wiring-auditor, с ограниченными kubeconfig - чтобы было видно, как приложение ведёт себя с теми kind’ами, к которым у роли нет доступа.

Чего пока нет

Чтобы не было сюрпризов:

  • Подписи нет. Ни macOS (Developer ID), ни Windows (SmartScreen). Подписать можно — инструкция в docs/code-signing.md, но аккаунта разработчика Apple у меня пока нет, а в Windows нужен Azure Artifact Signing.

  • Метрики требуют metrics-server. Без него колонки CPU и Memory и строки usage остаются пустыми; в демо это лечится флагом --with-metrics. С metrics-server на графе у нагрузок, упирающихся в 80 % лимита, появляются значки cpu 85% / mem 92%.

  • Кастомные ресурсы не отслеживаются для графа. Их kind’и видны в навигаторе, по ним открывается живая таблица с YAML, diff и apply - как у встроенных. Но в сам граф они не попадают, кроме случая, когда такой объект владеет чем-то из отслеживаемых (Certificate, владеющий Secret, или Rollout, владеющий ReplicaSet’ами); такие узлы включаются чипом Custom.

  • Один кластер за раз. Переключение на другой кластер - это переподключение сессии, а не вкладка.

  • Профилирование и трассировки не делал - только то, что отдаёт сам API кластера.

Где это лежит

Если напишете, чего не хватает в первую очередь, - сделаю. Сейчас в планах: подпись сборок и Helm-релизы в графе.