Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Installer ClickHouse Operator avec kubectl

View as MarkdownEdit this pageReport an issueSet up docs MCP

Ce guide explique comment installer ClickHouse Operator à l'aide de kubectl et de fichiers manifeste.

Prérequis

  • cluster Kubernetes v1.28.0 ou version ultérieure
  • kubectl v1.28.0 ou version ultérieure
  • permissions d’administrateur du cluster

Installer à partir des manifestes de la dernière version

Installez l’opérateur et les CRD depuis la dernière version publiée :

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

L’application côté serveur est nécessaire, car l’ensemble des CRD dépasse la limite de taille de l’application côté client. Pour les environnements qui ne prennent en charge que l’application côté client, utilisez la variante de CRD sans descriptions :

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

Cela va :

  1. Créer l’espace de noms clickhouse-operator-system
  2. Installer les définitions de ressources personnalisées (CRD) pour ClickHouseCluster et KeeperCluster
  3. Créer les ServiceAccounts, Roles et RoleBindings nécessaires
  4. Déployer le controller manager de l’opérateur
  5. Enregistrer les webhooks pour la validation des ressources et l’attribution de valeurs par défaut
  6. Configurer les certificats SSL à l’aide de cert-manager
  7. Activer le point de terminaison de métriques

Vérifier l’installation

Vérifiez que l’opérateur est bien en cours d’exécution :

kubectl get pods -n clickhouse-operator-system

Résultat attendu :

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

Vérifiez que les CRD sont installés :

kubectl get crd | grep clickhouse.com

Résultat attendu :

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

Configurer des options de déploiement personnalisées

Si vous souhaitez configurer les options de déploiement de l'opérateur, suivez les étapes ci-dessous.

Cloner le dépôt

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

Configurer les options d'installation

Modifiez config/default/kustomization.yaml pour activer ou désactiver les fonctionnalités selon vos besoins.

  • Pour désactiver les webhooks, mettez en commentaire les sections [WEBHOOK] et [CERTMANAGER].
  • Pour activer le point de terminaison de métriques sécurisé, mettez en commentaire les sections [METRICS] et décommentez les sections [METRICS SECURE] et [CERTMANAGER].
  • Pour activer ServiceMonitor pour Prometheus Operator, décommentez la section [PROMETHEUS].
  • Pour activer les politiques réseau de l'opérateur, décommentez la section [NETWORK POLICY].

Générer et déployer

Générez les manifestes de l'opérateur et appliquez-les :

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