Модуль managed-starrocks

Обзор модуля

StarRocks — высокопроизводительная аналитическая СУБД (OLAP) для аналитики в реальном времени, хранилищ данных и BI-нагрузок. Архитектура Massively Parallel Processing (MPP) с узлами Frontend (FE) и Backend (BE), поддержка SQL, векторизованного исполнения запросов и высокоскоростной загрузки данных (в том числе Stream Load).

Модуль managed-starrocks разворачивает и обслуживает кластеры StarRocks в Kubernetes-кластерах через декларативный API. Он позволяет командам создавать аналитические базы данных, задавать политики размеров и конфигурации, а также масштабировать вычислительные ресурсы и хранилище под нагрузку.

Основные возможности:

• Автоматическое развёртывание. Разворачивает инстанс StarRocks при помощи простой YAML-конфигурации.
• Управление политиками. Отдельный ресурс StarrocksClass для ограничений по ресурсам, настроек FE/BE по умолчанию и CEL-валидации пользовательских конфигураций.
• Настройка под аналитику. Параметры загрузки данных (streamingLoadMaxMb, loadProcessMaxMemoryLimitPercent) и управления каталогом (catalogTrashExpireSecond).
• Поддержка TLS. Опциональный TLS для HTTP-прокси FE (HTTPS, порт 8443) через cert-manager или пользовательские сертификаты. Порт MySQL-запросов (9030) остаётся без TLS.
• Статус. Условия валидности конфигурации, масштабирования и доступности; при TLS — status.certificate.server (TTL / failure).

Включение модуля

Для включения модуля managed-starrocks примените следующий манифест:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: managed-starrocks
spec:
  enabled: true
  version: 1

После включения модуля автоматически будет создан кластерный ресурс StarrocksClass с именем default.

Быстрый старт

Примеры использования модуля — в разделе «Примеры использования» руководства администратора и в разделе «Примеры использования» руководства пользователя.

Основные ресурсы

Модуль managed-starrocks предлагает инструменты для двух условных ролей Пользователь и Администратор. Основными объектами модуля являются ресурсы Starrocks, StarrocksClass и контроллер состояния StarRocks Operator.

Условная роль Администратор управляет cluster-wide-ресурсом StarrocksClass и создаёт шаблоны валидаций, правила размещения и конфигурацию FE/BE по умолчанию для инстансов StarRocks в Deckhouse Kubernetes Platform (DKP). Также у этой роли есть доступ к системному неймспейсу d8-managed-starrocks, где развёрнут StarRocks Operator, к его сервисным логам и состоянию.

Условная роль Пользователь управляет ресурсом Starrocks и конфигурирует аналитическую базу данных в рамках ограничений, заданных Администратором в StarrocksClass.

Ресурсы Администратора

StarrocksClass

Ресурс StarrocksClass позволяет ограничить создание невалидных конфигураций и предопределить значения по умолчанию для настроек StarRocks FE/BE. Каждый ресурс Starrocks обязательно должен быть связан с существующим ресурсом StarrocksClass. Перед развёртыванием сервиса вся конфигурация будет проверена по соответствующему StarrocksClass. Подробности — в руководстве администратора.

StarRocks Operator

При включении модуля контроллер StarRocks Operator разворачивается в системном неймспейсе d8-managed-starrocks и согласовывает состояния ресурсов Starrocks и конечного сервиса StarRocks во всех пользовательских неймспейсах.

Ресурсы Пользователя

Starrocks

Основной ресурс, который описывает желаемое состояние аналитической базы данных StarRocks. Должен быть создан внутри пользовательского неймспейса и определяет желаемое состояние развёрнутого кластера StarRocks. Подробности — в руководстве пользователя.