Instalar o ClickHouse Operator com kubectl

Este guia mostra como instalar o ClickHouse Operator usando kubectl e arquivos de manifesto.

Este guia mostra como instalar o ClickHouse Operator usando kubectl e arquivos de manifesto.

​

Pré-requisitos

• cluster do Kubernetes v1.28.0 ou posterior
• kubectl v1.28.0 ou posterior
• permissões de administrador do cluster

​

Instalar a partir dos manifestos da versão

É necessário o cert-manager para emitir certificados de webhook.

Instale o operador e os CRDs da versão mais recente:

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

A aplicação do lado do servidor é necessária porque os CRDs combinados excedem o limite de tamanho da aplicação do lado do cliente. Para ambientes que oferecem suporte apenas à aplicação do lado do cliente, use a variante de CRD sem descrições:

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

Isso vai:

1. Criar o espaço de nomes clickhouse-operator-system
2. Instalar CustomResourceDefinitions (CRDs) para ClickHouseCluster e KeeperCluster
3. Criar os ServiceAccounts, Roles e RoleBindings necessários
4. Implantar o controller manager do operador
5. Registrar webhooks para validação de recursos e aplicação de valores padrão
6. Configurar certificados SSL usando cert-manager
7. Habilitar o endpoint de métricas

​

Verifique a instalação

Verifique se o operador está em execução:

kubectl get pods -n clickhouse-operator-system

Saída esperada:

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

Verifique se os CRDs estão instalados:

kubectl get crd | grep clickhouse.com

Saída esperada:

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

​

Configurar opções personalizadas de implantação

Se quiser configurar as opções de implantação do operador, siga as etapas abaixo.

1. ​

   Clonar o repositório

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

   Configurar opções de instalação

   Edite config/default/kustomization.yaml para ativar ou desativar recursos, conforme necessário.

   • Para desativar os webhooks, comente as seções [WEBHOOK] e [CERTMANAGER].
   • Para ativar o endpoint seguro de métricas, comente as seções [METRICS] e descomente as seções [METRICS SECURE] e [CERTMANAGER].
   • Para ativar o ServiceMonitor do Prometheus Operator, descomente a seção [PROMETHEUS].
   • Para ativar as políticas de rede do operador, descomente a seção [NETWORK POLICY].
3. ​

   Compilar e implantar

   Compile os manifestos do operador e aplique-os:

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