Problems: cards, namespace and node boxes and the tree carry a yellow or red badge, computed on the server from object state (crash loops, image pulls, pending and unschedulable pods, readiness older than 2 minutes, a stuck rollout, a failed CronJob run, Services without endpoints, Ingresses to missing Services, node conditions), recent Warning events (notable reasons at once, others after five repeats) and Deckhouse ClusterAlerts mapped by their labels. A Problems panel lists them all. Checked against the live cluster: upmeter's synthetic probe pods and ingress-nginx's fakeservice Ingresses are excluded, they fail on purpose. Actions: restart, scale, run a CronJob now, suspend/resume, delete a pod, cordon/uncordon. They run with the viewer's bearer token from the DexAuthenticator (sendAuthorizationHeader), buttons follow a SelfSubjectAccessReview, the service account stays read-only. Cross-site writes are refused by Sec-Fetch-Site/Origin/content type. Scale retries on conflict: right after a restart a single Get+Update got 409. Load (metrics.k8s.io against requests/limits/allocatable, per-pod table) and an Events tab. Cards are locked until the padlock is opened; the map exports to PNG; the page refreshes badges every minute in place. Performance, measured on the live cluster: - layout of big views 3-4x faster: equal-size cards with no edges are laid out on the grid ELK would produce (same sizes, checked against ELK on a frozen node view), skipping ~8 ms per ELK call; - hubble-relay gets ~20% fewer flows: the to-overlay copy of pod-to-pod traffic is dropped at the agents; 331/331 directions unchanged; - static files carry ETags, a reload revalidates instead of pulling ~2 MB of vendored scripts. KUBECONFIG is honoured for running the binary on a workstation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
111 lines
9.1 KiB
YAML
111 lines
9.1 KiB
YAML
type: object
|
||
properties:
|
||
traffic:
|
||
description: Живой трафик между workload'ами из Cilium Hubble Relay.
|
||
properties:
|
||
mode:
|
||
description: |
|
||
Когда читать потоки из Hubble.
|
||
|
||
- `Continuous` — поток из Hubble открыт всегда, поэтому любое окно трафика заполнено сразу при открытии карты. На нагруженном кластере стоит hubble-relay около 100–150m CPU.
|
||
- `OnDemand` — поток открывается при первом запросе трафика и закрывается через `onDemandIdleMinutes` без запросов. Пока карту никто не смотрит, нагрузки почти нет, но окна заполняются только во время работы с картой.
|
||
- `Disabled` — без подключения к Hubble, карта показывает только связи по конфигурации.
|
||
|
||
Трафик выключен и тогда, когда выключен модуль `cilium-hubble`.
|
||
retentionMinutes:
|
||
description: |
|
||
На сколько минут назад могут смотреть окна трафика. Память растёт вместе с этим значением и с числом различных соединений в кластере.
|
||
onDemandIdleMinutes:
|
||
description: В режиме `OnDemand` — сколько минут поток остаётся открытым после последнего запроса трафика.
|
||
collectInfraTraffic:
|
||
description: |
|
||
Собирать также пробы kubelet и прочий трафик с хостов нод, трафик между нодами, проверки Cilium health и DNS.
|
||
|
||
По умолчанию выключено: на обычном кластере это около трёх четвертей всех потоков, ни один из них не привязан к workload'у, а отсев на агентах Hubble снижает нагрузку на hubble-relay в несколько раз.
|
||
actions:
|
||
description: Изменения, которые карта может вносить в кластер.
|
||
properties:
|
||
enabled:
|
||
description: |
|
||
Кнопки: перезапустить workload, масштабировать Deployment или StatefulSet, удалить под, запустить CronJob сейчас или приостановить его, закрыть ноду для новых подов (cordon).
|
||
|
||
Каждое действие выполняется от имени самого пользователя: DexAuthenticator передаёт модулю его токен, и API-сервер проверяет права по RBAC этого пользователя. Сервисный аккаунт модуля остаётся только на чтение, кнопка показывается, только если роль пользователя разрешает действие, а в аудит-логе API-сервера записан пользователь.
|
||
|
||
Нужен модуль `user-authn` или `externalAuthentication`, который кладёт в заголовок `Authorization` токен, принимаемый API-сервером. Если выключено, токен пользователя модулю не передаётся вовсе.
|
||
logs:
|
||
properties:
|
||
tailLines:
|
||
description: Сколько последних строк лога контейнера показывает вкладка «Логи».
|
||
systemNamespacePrefixes:
|
||
description: |
|
||
Namespace, которые в дереве инвентаря попадают в группу «Системные». Элемент, заканчивающийся на `-`, сравнивается как префикс, остальные — по имени целиком.
|
||
ingressClass:
|
||
description: |
|
||
Класс Ingress-контроллера для веб-интерфейса.
|
||
|
||
Опциональный параметр. По умолчанию используется глобальное значение `modules.ingressClass`.
|
||
nodeSelector:
|
||
description: |
|
||
Аналогично параметру Kubernetes `spec.nodeSelector` у подов.
|
||
|
||
Если параметр не указан или указано `false`, значение будет определено [автоматически](https://deckhouse.ru/products/kubernetes-platform/documentation/v1/#выделение-узлов-под-определенный-вид-нагрузки).
|
||
tolerations:
|
||
description: |
|
||
Аналогично параметру Kubernetes `spec.tolerations` у подов.
|
||
|
||
Если параметр не указан или указано `false`, значение будет определено [автоматически](https://deckhouse.ru/products/kubernetes-platform/documentation/v1/#выделение-узлов-под-определенный-вид-нагрузки).
|
||
auth:
|
||
description: |
|
||
Доступ к веб-интерфейсу.
|
||
|
||
Любой, кого сюда пустили, видит все namespace, манифесты workload'ов, Service и Ingress (Secret — никогда) и логи контейнеров — через собственную read-only-учётку модуля. Ограничивайте доступ через `allowedUserGroups`.
|
||
properties:
|
||
externalAuthentication:
|
||
description: |
|
||
Параметры для подключения внешней аутентификации на основе механизма Ingress NGINX [external-auth](https://kubernetes.github.io/ingress-nginx/examples/auth/external-auth/).
|
||
|
||
> Внешняя аутентификация включается автоматически, если включен модуль [user-authn](https://deckhouse.ru/modules/user-authn/).
|
||
properties:
|
||
authURL:
|
||
description: URL сервиса аутентификации. Если пользователь прошёл аутентификацию, сервис должен вернуть код ответа HTTP 200.
|
||
authSignInURL:
|
||
description: URL, куда будет перенаправлен пользователь для прохождения аутентификации (если сервис аутентификации вернул код ответа HTTP, отличный от 200).
|
||
allowedUserEmails:
|
||
description: |
|
||
Email пользователей, которым разрешено открывать веб-интерфейс.
|
||
|
||
Используется, если включен модуль `user-authn` или задан параметр `externalAuthentication`.
|
||
allowedUserGroups:
|
||
description: |
|
||
Группы пользователей, которым разрешено открывать веб-интерфейс.
|
||
|
||
Используется, если включен модуль `user-authn` или задан параметр `externalAuthentication`.
|
||
|
||
**Внимание!** При использовании совместно с модулем [user-authn](https://deckhouse.ru/modules/user-authn/) эти группы нужно добавить в соответствующее поле DexProvider.
|
||
whitelistSourceRanges:
|
||
description: Список CIDR, которым разрешено открывать веб-интерфейс.
|
||
https:
|
||
description: |
|
||
Тип сертификата.
|
||
|
||
Этот параметр полностью переопределяет глобальные настройки `global.modules.https`.
|
||
properties:
|
||
mode:
|
||
description: |
|
||
Режим работы HTTPS:
|
||
- `CertManager` — веб-интерфейс по HTTPS с сертификатом от ClusterIssuer из `certManager.clusterIssuerName`;
|
||
- `CustomCertificate` — веб-интерфейс по HTTPS с сертификатом из namespace `d8-system`;
|
||
- `Disabled` — веб-интерфейс только по HTTP;
|
||
- `OnlyInURI` — веб-интерфейс по HTTP за внешним HTTPS-балансировщиком, который терминирует TLS; ссылки формируются со схемой HTTPS.
|
||
certManager:
|
||
properties:
|
||
clusterIssuerName:
|
||
description: ClusterIssuer, через который получается сертификат.
|
||
customCertificate:
|
||
properties:
|
||
secretName:
|
||
description: |
|
||
Имя Secret в namespace `d8-system` с сертификатом для веб-интерфейса.
|
||
|
||
Secret должен быть в формате [kubernetes.io/tls](https://kubernetes.github.io/ingress-nginx/user-guide/tls/#tls-secrets).
|