Skip to content

Установка Enterprise ​

Для production используйте Kubernetes. Локальный checkout и Compose подходят для оценки и разработки; см. Настройку. Образы и чарты Enterprise требуют учётных данных реестра из поставки. Это отдельные артефакты, отличающиеся от публичных образов Community.

Требования ​

  • Поддерживаемый Kubernetes, Helm 3.8+ и настроенный контекст kubectl.
  • PostgreSQL с подготовленными базой, пользователем и DSN для nxs-anomaly. Пример использует внешнюю БД; эталонный образ развёртывания — PostgreSQL17.
  • Точный release tag, OCI-ссылка на Enterprise chart и учётная запись реестра из поставки. Версии API, worker и UI должны совпадать.
  • Secret для скачивания образов, подготовленный платформой в namespace приложения.
  • Bash и защищённое место для файла окружения приложения.

Kubernetes с внешним PostgreSQL ​

Задайте EE_CHART_REF равным OCI-ссылке на выданный чарт nxs-anomaly-enterprise, RELEASE_VERSION — его версии, REGISTRY_HOST — адресу реестра. Войдите в реестр Helm, не оставляя пароль в истории shell:

bash
read -r -p 'Registry username: ' REGISTRY_USER
read -r -s -p 'Registry password: ' REGISTRY_PASSWORD; printf '\n'
printf '%s' "$REGISTRY_PASSWORD" | helm registry login "$REGISTRY_HOST" \
  --username "$REGISTRY_USER" --password-stdin
unset REGISTRY_PASSWORD

Создайте namespace nxs-anomaly, подготовьте в нём image pull Secret registry-credentials и файл application.env с правами 0600. Он должен содержать NXS_ANOMALY_DB_DSN, bootstrap username/password администратора и credentials провайдеров. Параметры DSN/TLS получите у администратора БД; не используйте пример пароля для production.

bash
kubectl create namespace nxs-anomaly
kubectl -n nxs-anomaly create secret generic nxs-anomaly-env \
  --from-env-file=application.env
helm upgrade --install nxs-anomaly "$EE_CHART_REF" \
  --version "$RELEASE_VERSION" --namespace nxs-anomaly \
  --set existingSecret.enabled=true --set-string existingSecret.name=nxs-anomaly-env \
  --set-string 'imagePullSecrets[0].name=registry-credentials' \
  --wait --timeout 5m
kubectl -n nxs-anomaly port-forward service/nxs-anomaly-frontend 3100:8080

Откройте http://localhost:3100 и войдите с bootstrap credentials. После проверки обычного административного доступа удалите bootstrap-пароль из Secret: оставленные переменные сбрасывают пароль аккаунта при каждом старте. Встроенный PostgreSQL в чарте выключен по умолчанию; DSN выше обязателен. Перед приёмом инцидентов настройте production ingress, сертификаты, резервное копирование, исходящие транспорты и проверки готовности.

Локальная оценка и разработка ​

Используйте приватный checkout исходников из поставки, а не GitHub CE. Скопируйте .env.example в .env, заполните обязательные секреты БД/bootstrap и запустите docker compose up --build. Compose использует dev-настройки; именованный PostgreSQL volume переживает обычный down, а down -v удаляет данные. Таблица компонентов, health checks и команды запуска Go приведены в Настройке. Инструменты сборки должны соответствовать go.mod; для фронтенда нужен Node22.12+.

На bare metal используйте согласованные версии образов API/worker/фронтенда или сборку из поставленных исходников. Настройте PostgreSQL, same-origin обратный прокси и управление службами по Развёртыванию. Не включайте scheduler в каждой HTTP-реплике: API запускается с --no-scheduler, работа планировщика выполняется отдельными worker.

Дополнительные компоненты Enterprise ​

Сама установка не включает SSO или аналитические сервисы. Настройка OIDC описана в аутентификации API, Kafka/ClickHouse и consumer — в Потоке аналитики. До production изучите HA, Бэкапы, Безопасность и Конфигурацию.

nxs-anomaly · Documentation