Перейти к основному содержанию
Это руководство посвящено установке ClickHouse Operator с помощью kubectl и манифестов.

​
Предварительные требования

  • Кластер Kubernetes v1.28.0 или новее
  • kubectl v1.28.0 или новее
  • Права администратора кластера

​
Установка из манифестов релиза

Для выпуска сертификатов вебхука требуется cert-manager.
Установите оператор и CRD из последнего релиза: 
kubectl apply -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator.yaml
Это приведет к следующему:
  1. Создаст пространство имен clickhouse-operator-system
  2. Установит определения пользовательских ресурсов (CRD) для ClickHouseCluster и KeeperCluster
  3. Создаст необходимые ServiceAccount, Role и RoleBinding
  4. Развернет controller manager оператора
  5. Зарегистрирует вебхуки для валидации ресурсов и задания значений по умолчанию
  6. Настроит SSL-сертификаты с помощью cert-manager
  7. Включит конечную точку метрик

​
Проверьте установку

Убедитесь, что оператор запущен: 
kubectl get pods -n clickhouse-operator-system
Ожидаемый вывод: 
NAME                                                 READY   STATUS    RESTARTS   AGE
clickhouse-operator-controller-manager-xxxxxxxxxx    1/1     Running   0          1m
Убедитесь, что CRD установлены: 
kubectl get crd | grep clickhouse.com
Ожидаемый результат: 
clickhouseclusters.clickhouse.com    2025-01-06T00:00:00Z
keeperclusters.clickhouse.com        2025-01-06T00:00:00Z

​
Настройка пользовательских параметров развертывания

Если вы хотите настроить параметры развертывания оператора, выполните следующие шаги.
1

​
Клонируйте репозиторий

git clone https://github.com/ClickHouse/clickhouse-operator.git
cd clickhouse-operator
2

​
Настройте параметры установки

Измените config/default/kustomization.yaml, чтобы включить или отключить нужные возможности.
  • Чтобы отключить вебхуки, закомментируйте разделы [WEBHOOK] и [CERTMANAGER].
  • Чтобы включить защищенную конечную точку метрик, закомментируйте разделы [METRICS], а затем раскомментируйте разделы [METRICS SECURE] и [CERTMANAGER].
  • Чтобы включить ServiceMonitor для Prometheus Operator, раскомментируйте раздел [PROMETHEUS].
  • Чтобы включить сетевые политики оператора, раскомментируйте раздел [NETWORK POLICY].
3

​
Сборка и развертывание

Соберите манифесты оператора и примените их:
make build-installer VERSION=<required operator version> [IMG=<custom registry path>]
kubectl apply -k dist/install.yaml
Последнее изменение 19 июня 2026 г.