kubectl を使用した ClickHouse Operator のインストール

このガイドでは、kubectl とマニフェストファイルを使用した ClickHouse Operator のインストールについて説明します。

このガイドでは、kubectl とマニフェストファイルを使用した ClickHouse Operator のインストールについて説明します。

​

前提条件

• Kubernetes クラスター v1.28.0 以降
• kubectl v1.28.0 以降
• クラスター管理者権限

​

リリースマニフェストを使ったインストール

webhook 証明書の発行には cert-manager が必要です。

最新リリースから operator と CRD をインストールします。

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

これにより、以下が実行されます。

1. clickhouse-operator-system ネームスペースを作成
2. ClickHouseCluster と KeeperCluster 用の CustomResourceDefinitions (CRD) をインストール
3. 必要な ServiceAccount、ロール、RoleBinding を作成
4. operator の controller manager をデプロイ
5. リソースの検証とデフォルト設定のための webhook を登録
6. cert-manager を使用して SSL 証明書を設定
7. メトリクスエンドポイントを有効化

​

インストールを確認する

operator が稼働していることを確認します。

kubectl get pods -n clickhouse-operator-system

想定される出力:

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

CRD がインストールされていることを確認します。

kubectl get crd | grep clickhouse.com

出力例:

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

​

カスタムのデプロイメントオプションを設定する

operator のデプロイメントオプションを設定するには、以下の手順に従ってください。

1. ​

   リポジトリをクローンする

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

   インストールオプションを設定する

   必要に応じて機能を有効または無効にするため、config/default/kustomization.yaml を編集します。

   • webhooks を無効にするには、[WEBHOOK] セクションと [CERTMANAGER] セクションをコメントアウトします。
   • セキュアなメトリクス endpoint を有効にするには、[METRICS] セクションをコメントアウトし、[METRICS SECURE] セクションと [CERTMANAGER] セクションのコメントを解除します。
   • Prometheus Operator の ServiceMonitor を有効にするには、[PROMETHEUS] セクションのコメントを解除します。
   • operator のネットワークポリシーを有効にするには、[NETWORK POLICY] セクションのコメントを解除します。
3. ​

   ビルドしてデプロイする

   operator のマニフェストをビルドして適用します。

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