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

Helm デプロイメントオプション (v1.x)

非推奨 — v1.x チャート

このページでは、メンテナンスモードにある v1.x インラインテンプレート Helm チャートのデプロイメントオプションについて説明します。v2.x チャートについては、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: 外部シークレット (本番環境で推奨)​

認証情報を 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"

外部 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 のエンドポイントを公開する手順については、イングレス設定を参照してください。

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

既存のインフラストラクチャがある組織では、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

次のステップ​