Helm デプロイオプション

このガイドでは、Helm を使用して ClickStack をデプロイする際の高度なオプションについて説明します。基本的なインストール手順については、Helm デプロイの基本ガイドを参照してください。

概要

ClickStack の Helm チャートは、複数のデプロイ構成をサポートします：

• フルスタック（デフォルト）- すべてのコンポーネントを含む
• 外部 ClickHouse - 既存の ClickHouse クラスターを使用
• 外部 OTel collector - 既存の OTel インフラストラクチャを使用
• 最小デプロイメント - HyperDX のみをデプロイし、その他のコンポーネントは外部のものを使用

外部 ClickHouse

既存の ClickHouse クラスター（ClickHouse Cloud を含む）がある場合は、組み込みの ClickHouse を無効にして、外部インスタンスに接続できます。

オプション 1: インライン設定（開発／テスト向け）

手軽なテストや本番以外の環境では、この方法を使用してください。

# values-external-clickhouse.yaml \{#values-external-clickhouseyaml}
clickhouse:
  enabled: false  # 組み込みClickHouseを無効化

otel:
  clickhouseEndpoint: "tcp://your-clickhouse-server:9000"
  clickhousePrometheusEndpoint: "http://your-clickhouse-server:9363"  # 任意

hyperdx:
  defaultConnections: |
    [
      {
        "name": "外部ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]

以下の構成でインストールします：

helm install my-clickstack clickstack/clickstack -f values-external-clickhouse.yaml

オプション 2: 外部シークレット（本番環境で推奨）

認証情報を Helm の設定から分離しておきたい本番環境でのデプロイでは、次のようにします。

ClickHouse Cloud を使用する

ClickHouse Cloud を利用する場合:

# values-clickhouse-cloud.yaml \{#values-clickhouse-cloudyaml}
clickhouse:
  enabled: false
  persistence:
    enabled: false

otel:
  clickhouseEndpoint: "tcp://your-cloud-instance.clickhouse.cloud:9440?secure=true"

hyperdx:
  useExistingConfigSecret: true
  existingConfigSecret: "clickhouse-cloud-config"
  existingConfigConnectionsKey: "connections.json"
  existingConfigSourcesKey: "sources.json"

ClickHouse Cloud への接続手順の全体像については、「ClickHouse Cloud 接続の作成」 を参照してください。

外部 OTel collector

既存の OTel collector インフラストラクチャがある場合は:

# values-external-otel.yaml \{#values-external-otelyaml}
otel:
  enabled: false  # 組み込みのOTel collectorを無効化

hyperdx:
  otelExporterEndpoint: "http://your-otel-collector:4318"

helm install my-clickstack clickstack/clickstack -f values-external-otel.yaml

イングレスを介して OTel collector のエンドポイントを公開する手順については、Ingress 設定を参照してください。

最小限のデプロイメント

既存のインフラストラクチャがある組織の場合は、HyperDX のみをデプロイします。

# values-minimal.yaml \{#values-minimalyaml}
clickhouse:
  enabled: false

otel:
  enabled: false

hyperdx:
  otelExporterEndpoint: "http://your-otel-collector:4318"
  
  # オプション1: インライン（テスト用）
  defaultConnections: |
    [
      {
        "name": "External ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]
  
  # オプション2: 外部シークレット（本番環境用）
  # useExistingConfigSecret: true
  # existingConfigSecret: "my-external-config"
  # existingConfigConnectionsKey: "connections.json"
  # existingConfigSourcesKey: "sources.json"

helm install my-clickstack clickstack/clickstack -f values-minimal.yaml

次のステップ

• Configuration Guide - API キー、シークレット、イングレスのセットアップ
• Cloud Deployments - GKE、EKS、AKS 向けの特有の設定
• Main Helm Guide - 基本インストール