Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Instalar el ClickHouse Operator con kubectl

View as MarkdownEdit this pageReport an issueSet up docs MCP

Esta guía explica cómo instalar el ClickHouse Operator con kubectl y archivos de manifiesto.

Requisitos previos

  • Clúster de Kubernetes v1.28.0 o posterior
  • kubectl v1.28.0 o posterior
  • Permisos de administrador del clúster

Instalar desde los manifiestos de la versión

Instale el operador y los CRD de la versión más reciente:

kubectl apply --server-side --force-conflicts -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator.yaml

La aplicación del lado del servidor es obligatoria porque los CRD combinados superan el límite de tamaño de la aplicación del lado del client. Para los entornos que solo admiten la aplicación del lado del client, use la variante de CRD sin descripciones:

kubectl apply -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator-stripped-crds.yaml

Esto hará lo siguiente:

  1. Crear el espacio de nombres clickhouse-operator-system
  2. Instalar las definiciones de recursos personalizados (CRD) para ClickHouseCluster y KeeperCluster
  3. Crear las ServiceAccounts, Roles y RoleBindings necesarias
  4. Desplegar el controller manager del operador
  5. Registrar webhooks para la validación de recursos y la aplicación de valores predeterminados
  6. Configurar certificados SSL con cert-manager
  7. Habilitar el endpoint de métricas

Verificar la instalación

Compruebe que el operador se esté ejecutando:

kubectl get pods -n clickhouse-operator-system

Resultado esperado:

NAME                                                 READY   STATUS    RESTARTS   AGE
clickhouse-operator-controller-manager-xxxxxxxxxx    1/1     Running   0          1m

Verifique que las CRD estén instaladas:

kubectl get crd | grep clickhouse.com

Resultado esperado:

clickhouseclusters.clickhouse.com    2025-01-06T00:00:00Z
keeperclusters.clickhouse.com        2025-01-06T00:00:00Z

Configurar opciones personalizadas para desplegar

Si quieres configurar las opciones para desplegar el operador, sigue estos pasos.

Clonar el repositorio

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

Configurar las opciones de instalación

Edita config/default/kustomization.yaml para habilitar o deshabilitar funciones según sea necesario.

  • Para deshabilitar los webhooks, comenta las secciones [WEBHOOK] y [CERTMANAGER].
  • Para habilitar un endpoint de métricas seguro, comenta las secciones [METRICS] y descomenta las secciones [METRICS SECURE] y [CERTMANAGER].
  • Para habilitar ServiceMonitor para Prometheus Operator, descomenta la sección [PROMETHEUS].
  • Para habilitar las políticas de red del operador, descomenta la sección [NETWORK POLICY].

Compilar y desplegar

Compila los manifiestos del operador y aplícalos:

make build-installer VERSION=<required operator version> [IMG=<custom registry path>]
kubectl apply --server-side --force-conflicts -f dist/install.yaml
Navigation