Helm デプロイメントオプション

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

概要

ClickStack の Helm チャートは複数のデプロイメント構成をサポートしています:

フルスタック (デフォルト) - すべてのコンポーネントを含む構成
外部 ClickHouse - 既存の ClickHouse クラスターを使用する構成
外部 OTel collector - 既存の OTel インフラストラクチャを使用する構成
最小限のデプロイメント - HyperDX のみを含み、その他は外部依存関係として利用する構成

外部 ClickHouse

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

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

この方法は、手早くテストしたい場合や本番以外の環境向けです。

# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # Disable the built-in ClickHouse

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

hyperdx:
  defaultConnections: |
    [
      {
        "name": "External 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: 外部 Secret（本番環境で推奨）

本番環境へのデプロイで、認証情報を Helm の設定とは分離して管理したい場合に使用します。

ClickHouse Cloud を使用する

特に ClickHouse Cloud を使用する場合は、次のとおりです。

# values-clickhouse-cloud.yaml
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
otel:
  enabled: false  # Disable the built-in OTEL collector

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

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

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

最小構成でのデプロイメント

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

# values-minimal.yaml
clickhouse:
  enabled: false

otel:
  enabled: false

hyperdx:
  otelExporterEndpoint: "http://your-otel-collector:4318"
  
  # Option 1: Inline (for testing)
  defaultConnections: |
    [
      {
        "name": "External ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]
  
  # Option 2: External secret (production)
  # useExistingConfigSecret: true
  # existingConfigSecret: "my-external-config"
  # existingConfigConnectionsKey: "connections.json"
  # existingConfigSourcesKey: "sources.json"

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

次のステップ

構成ガイド - API キーとシークレット、およびイングレスのセットアップ
Cloud デプロイメント - GKE、EKS、AKS 向けの専用構成
メイン Helm ガイド - 基本的なインストール手順

概要​

外部 ClickHouse​

オプション 1: インライン設定（開発/テスト）​

オプション 2: 外部 Secret（本番環境で推奨）​

ClickHouse Cloud を使用する​

外部の OTel collector​

最小構成でのデプロイメント​

次のステップ​

概要