Подключение кластера

От команды в интерфейсе до первого подтверждённого снимка. Kubeconfig остаётся у вас.

Перед началом#

Установите Python 3, kubectl и Helm на компьютере, с которого доступен Kubernetes API.
Выберите нужный kubeconfig context. Установщику нужны права создать собственные компоненты и выдать выбранные namespace-права.
Разрешите исходящий HTTPS к api.oopps.ai и загрузку опубликованного образа агента. Endpoint и digest CLI получает от платформы.
Namespaces для наблюдения должны уже существовать. Облачные IAM-ключи для текущего Kubernetes-сбора не нужны.

kubectl config current-context
kubectl --context <ваш-context> cluster-info

1. Получите команду в Oopps#

Откройте платформу → «Подключить кластер». Скопируйте предложенную команду загрузки CLI и проверки SHA-256, затем команду подключения. Не заменяйте актуальную контрольную сумму значением из чужого примера.

Одноразовый код подключения действует 10 минут. Он позволяет подготовить и зарегистрировать подключение в организации, но не читать данные кластеров. Не публикуйте код в тикетах или скриншотах.

2. Выберите область в терминале#

CLI показывает Kubernetes context, имя, адрес платформы, закреплённый digest образа и будущие права. Выберите namespaces или конкретные workloads. Namespace-режим поддерживает CPU/RAM; строгий workload-режим — только инвентарь.

python3 ooppsctl.pyz cluster connect --help

3. Подтвердите установку#

После проверки прав подтвердите именно показанный context и область. CLI создаст подключение, установит агент в oopps-system, а Role/RoleBinding — в выбранных namespaces. Существующая установка и её credentials не перезаписываются.

В CLI 0.6.0 новые namespace-подключения включают CPU/RAM после подтверждения. Если Metrics API отсутствует, установка общего Metrics Server требует отдельного согласия. Можно явно продолжить только с инвентарём или использовать --without-metrics.

Как работает проверка и установка Metrics Server →

4. Дождитесь данных#

Готовый Pod или успешный Helm install ещё не означают подключение. CLI ждёт свежий heartbeat и первый снимок. Отдельно отображается доступность источника CPU/RAM: подключённый агент может ещё не иметь измерений.

При таймауте не запускайте повторную установку вслепую: частичные ресурсы сохраняются для диагностики, а дашборд продолжает ожидание. Разобрать ошибку установки →