Instalar el ClickHouse Operator con kubectl

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

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

Requiere cert-manager para emitir certificados para el webhook.

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

kubectl apply -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator.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 de despliegue

Si quieres configurar las opciones de despliegue del operador, sigue estos pasos.

1. ​

   Clonar el repositorio

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

   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].
3. ​

   Compilar e implementar

   Compila los manifiestos del operador y aplícalos:

   make build-installer VERSION=<required operator version> [IMG=<custom registry path>]
   kubectl apply -k dist/install.yaml