Стадия жизненного цикла модуля: Предварительная версия (preview)

У модуля есть требования для установки

Релиз

v0.0.3

Дата 2026-09-28
Модуль managed-clickhouse
Версия 0.0.3

Кратко

Структурирована документация и информация о релизах. Webhook’и и controller разделены на отдельные Deployment’ы.

Ключевые изменения

  • Changelog/release-notes процесс стал bilingual и автоматизирован CI.
  • Webhook’и и controller разделены на отдельные Deployment’ы.

v0.0.2

Дата 2026-09-02
Модуль managed-clickhouse
Версия 0.0.2
Каналы обновлений Alpha, Beta, Early Access, Stable, Rock Solid
Редакции FE, EE

Исправления

CRDs теперь хранятся также и в репозитории модуля managed-clickhouse-d8/crds

Добавлены аннотации для webhooks:

  • werf.io/deploy-dependency-deployment
  • werf.io/deploy-dependency-service

v0.0.1

Дата 2026-06-26
Модуль managed-clickhouse
Версия 0.0.1
Каналы обновлений Alpha, Beta, Early Access, Stable, Rock Solid
Редакции FE, EE

Реализованы базовые возможности для развёртывания и управления нодами Clickhouse в кластере DKP.

Создание standalone-серверов Clickhouse

Добавлен новый CRD Clickhouse, который позволяет разворачивать независимые ноды Clickhouse. При создании ресурса пользователь задаёт вычислительные ресурсы (CPU, память) и параметры хранилища.

Шаблоны конфигурации через ClickhouseClass

Добавлен CRD ClickhouseClass, который позволяет администраторам создавать именованные шаблоны для нод. Класс задаёт политику допустимых ресурсов (диапазоны CPU и памяти).

Валидация через webhooks

Все операции создания и изменения ресурсов Clickhouse и ClickhouseClass проходят через admission webhooks. Webhooks проверяют корректность параметров: допустимые диапазоны CPU и памяти, а также пользовательские правила, заданные администратором.

Кастомные правила валидации на CEL

Администраторы могут задавать произвольные правила валидации ресурсов Clickhouse в ClickhouseClass с помощью выражений CEL (Common Expression Language). Правила проверяются webhook-ом при каждом создании или изменении экземпляра Clickhouse, что позволяет реализовывать специфичные для организации ограничения без изменения кода оператора.

Поддержка distroless-образов

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

Поддержка серверных TLS-сертификатов

Реализована поддержка TLS-сертификатов для:

  • серверного TLS Clickhouse

Поддерживаются два режима управления сертификатами:

  • CertManager — выпуск и управление сертификатами через cert-manager
  • CustomCertificate — использование пользовательских Kubernetes Secret с сертификатами

Пример конфигурации:

apiVersion: managed-services.deckhouse.io/v1alpha1
kind: Clickhouse
metadata:
  name: clickhouse-sample
spec:
  tls:
    mode: CertManager
    certManager:
      clusterIssuerName: selfsigned
  clickhouseClassName: default
  instance:
    memory:
      size: "4Gi"
    cpu:
      cores: 1
      coreFraction: "75%"
    persistentVolumeClaim:
      size: "4Gi"
      storageClassName: local