メインコンテンツへスキップ
メインコンテンツへスキップ

Helm のデプロイオプション

チャートのバージョン 2.x

このページでは、v2.x のサブチャートベースの Helm チャートについて説明します。まだ v1.x のインラインテンプレートチャートを使用している場合は、Helm のデプロイオプション (v1.x) を参照してください。移行手順については、アップグレードガイド を参照してください。

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

概要​

ClickStack の Helm チャートは、複数のデプロイ構成に対応しています：

  • フルスタック (デフォルト) — すべてのコンポーネントを含み、オペレーターが管理
  • 外部 ClickHouse — 既存の ClickHouse クラスターを使用
  • 外部 OTel collector — 既存の OTel インフラストラクチャを使用
  • 最小構成のデプロイ — HyperDX のみを含み、依存先は外部

外部 ClickHouse​

既存の ClickHouse クラスター (ClickHouse Cloud を含む) をお使いの場合は、組み込みの ClickHouse を無効にして、外部のインスタンスに接続できます。

オプション 1: インライン設定 (開発/テスト用)​

この方法は、簡易テストや非本番環境で使用してください。接続情報は hyperdx.config と hyperdx.secrets で指定します：

# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # Disable the operator-managed ClickHouse

hyperdx:
  secrets:
    CLICKHOUSE_PASSWORD: "your-password"
    CLICKHOUSE_APP_PASSWORD: "your-password"

  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: 外部シークレット (本番環境で推奨)​

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

ClickHouse Cloudの使用​

ClickHouse Cloudの場合:

# values-clickhouse-cloud.yaml
clickhouse:
  enabled: false

hyperdx:
  secrets:
    CLICKHOUSE_PASSWORD: "your-cloud-password"
    CLICKHOUSE_APP_PASSWORD: "your-cloud-password"

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

外部 OTel collector​

既存の OTel collector 環境がある場合は、サブチャートを無効にします。

# values-external-otel.yaml
otel-collector:
  enabled: false  # Disable the subchart OTEL collector

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

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

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

最小構成のデプロイ​

既存のインフラがある場合は、HyperDX のみをデプロイします：

# values-minimal.yaml
clickhouse:
  enabled: false

otel-collector:
  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

次のステップ​