Helm 部署选项

使用 Helm 部署 ClickStack 的高级配置选项

Helm 图表版本 2.x

本页介绍的是基于子图表 的 v2.x Helm 图表。如果你仍在使用 v1.x 内联模板图表，请参阅 Helm 部署选项 (v1.x) 。如需迁移步骤，请参阅 升级指南。

本指南介绍使用 Helm 部署 ClickStack 的高级部署选项。有关基本安装，请参阅 Helm 部署主指南。

​

概述

ClickStack 的 Helm 图表支持多种部署配置：

• 完整栈 (默认) — 包含所有组件，由 Operator 管理
• 外部 ClickHouse — 使用现有的 ClickHouse 集群
• 外部 OTel collector — 使用现有的 OTel 基础设施
• 最小化部署 — 仅包含 HyperDX，依赖外部服务

​

外部 ClickHouse

如果你已有现成的 ClickHouse 集群 (包括 ClickHouse Cloud) ，可以禁用内置的 ClickHouse，并连接到外部实例。

​

选项 1：内联配置 (开发/测试)

这种方式适用于快速测试或非生产环境。通过 hyperdx.config 和 hyperdx.secrets 提供连接信息：

# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # 禁用由 operator 管理的 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：外部 Secret (推荐用于生产环境)

对于希望将凭据与 Helm 配置分开管理的生产环境部署：

​

创建配置文件

# 创建 connections.json
cat <<EOF > connections.json
[
  {
    "name": "Production ClickHouse",
    "host": "https://your-production-clickhouse.com",
    "port": 8123,
    "username": "hyperdx_user",
    "password": "your-secure-password"
  }
]
EOF

# 创建 sources.json
cat <<EOF > sources.json
[
  {
    "from": {
      "databaseName": "default",
      "tableName": "otel_logs"
    },
    "kind": "log",
    "name": "Logs",
    "connection": "Production ClickHouse",
    "timestampValueExpression": "TimestampTime",
    "displayedTimestampValueExpression": "Timestamp",
    "implicitColumnExpression": "Body",
    "serviceNameExpression": "ServiceName",
    "bodyExpression": "Body",
    "eventAttributesExpression": "LogAttributes",
    "resourceAttributesExpression": "ResourceAttributes",
    "severityTextExpression": "SeverityText",
    "traceIdExpression": "TraceId",
    "spanIdExpression": "SpanId"
  },
  {
    "from": {
      "databaseName": "default",
      "tableName": "otel_traces"
    },
    "kind": "trace",
    "name": "Traces",
    "connection": "Production ClickHouse",
    "timestampValueExpression": "Timestamp",
    "displayedTimestampValueExpression": "Timestamp",
    "implicitColumnExpression": "SpanName",
    "serviceNameExpression": "ServiceName",
    "traceIdExpression": "TraceId",
    "spanIdExpression": "SpanId",
    "durationExpression": "Duration"
  }
]
EOF

​

创建 Kubernetes Secret

kubectl create secret generic hyperdx-external-config \
  --from-file=connections.json=connections.json \
  --from-file=sources.json=sources.json

# 清理本地文件
rm connections.json sources.json

​

配置 Helm 使用该 Secret

# values-external-clickhouse-secret.yaml
clickhouse:
  enabled: false

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

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

​

使用 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  # 禁用子图表 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"
      }
    ]

  # 选项 2：外部 Secret（生产环境）
  # useExistingConfigSecret: true
  # existingConfigSecret: "my-external-config"
  # existingConfigConnectionsKey: "connections.json"
  # existingConfigSourcesKey: "sources.json"

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

​

后续步骤

• 配置指南 - API 密钥、Secret 和入口设置
• Cloud 部署 - GKE、EKS 和 AKS 的特定配置
• 升级指南 - 从 v1.x 迁移到 v2.x
• 附加清单 - 自定义 Kubernetes 对象
• Helm 主要指南 - 基本安装
• 部署选项 (v1.x) - v1.x 部署选项