Установка ClickHouse Operator с помощью Helm-чартов

В этом руководстве описана установка ClickHouse Operator с помощью Helm-чартов.

Требования

Кластер Kubernetes v1.28.0 или выше
helm v3.0 или выше
kubectl настроен для работы с вашим кластером

Установите Helm

Если у вас не установлен Helm:

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

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

helm version

Установите ClickHouse Operator

По умолчанию Helm-чарт разворачивает ClickHouse Operator с включёнными вебхуками и требует установленного cert-manager.

helm install cert-manager oci://quay.io/jetstack/charts/cert-manager -n cert-manager --create-namespace --set crds.enabled=true

Из OCI-репозитория Helm

Установите последнюю версию

    helm install clickhouse-operator oci://ghcr.io/clickhouse/clickhouse-operator-helm \
       --create-namespace \
       -n clickhouse-operator-system

Установите конкретную версию оператора

    helm install clickhouse-operator oci://ghcr.io/clickhouse/clickhouse-operator-helm \
       --create-namespace \
       -n clickhouse-operator-system \
       --set manager.image.tag=<operator version>

Из локального чарта

Клонируйте репозиторий и установите из локального чарта:

git clone https://github.com/ClickHouse/clickhouse-operator.git
cd clickhouse-operator
helm install clickhouse-operator ./dist/chart

Отслеживание отдельных пространств имен

По умолчанию оператор отслеживает все пространства имен. Чтобы ограничить их список, задайте controller.watchNamespaces. Элементы списка обрабатываются как шаблоны, поэтому {{ .Release.Namespace }} подставляется как пространство имен релиза и может сочетаться со статически заданными пространствами имен:

controller:
  watchNamespaces:
    - "{{ .Release.Namespace }}"
    - team-a

В командной строке --set интерпретирует фигурные скобки как синтаксис списка, поэтому используйте --set-json (Helm v3.10 или новее): --set-json 'controller.watchNamespaces=["{{ .Release.Namespace }}"]'. Чтобы отслеживать только пространство имен релиза с RBAC, ограниченным этим пространством имен:

controller:
  watchNamespaces:
    - "{{ .Release.Namespace }}"
rbac:
  namespaced: true

При rbac.namespaced: true разрешения manager оформляются в виде Role/RoleBinding в пространстве имен релиза, поэтому для наблюдения за другими пространствами имен требуется RBAC на уровне кластера (вариант по умолчанию).

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

Сведения о дополнительных параметрах конфигурации см. в файле values.yaml Helm-чарта