Параметры развертывания Helm (v1.x)

Устаревший чарт v1.xНа этой странице описаны параметры развертывания для Helm-чарта v1.x со встроенными шаблонами, который находится в режиме сопровождения. Сведения о чарте v2.x см. в разделе Параметры развертывания Helm. Инструкции по миграции см. в руководстве по обновлению.

В этом руководстве рассматриваются расширенные параметры развертывания ClickStack с помощью Helm. Сведения о базовой установке см. в основном руководстве по развертыванию Helm.

Обзор

Helm-чарт ClickStack поддерживает несколько конфигураций развертывания:

Полный стек (по умолчанию) — включены все компоненты
Внешний ClickHouse — используется существующий кластер ClickHouse
Внешний OTel collector — используется существующая инфраструктура OTel
Минимальное развертывание — только HyperDX и внешние зависимости

Внешний ClickHouse

Если у вас уже есть кластер ClickHouse (включая ClickHouse Cloud), вы можете отключить встроенный ClickHouse и подключиться к внешнему экземпляру.

Вариант 1: Встроенная конфигурация (для разработки/тестирования)

Используйте этот подход для быстрого тестирования или в непроизводственных средах:

# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # Отключить встроенный ClickHouse

otel:
  clickhouseEndpoint: "tcp://your-clickhouse-server:9000"
  clickhousePrometheusEndpoint: "http://your-clickhouse-server:9363"  # Необязательно

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:

Создайте файлы конфигурации

# Создать 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

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 для использования секрета

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

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

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
  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  # Отключить встроенный 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"

  # Вариант 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

Следующие шаги

Руководство по конфигурации (v1.x) - ключи API, секреты и настройка входного шлюза
Развертывания в Cloud (v1.x) - конфигурации для GKE, EKS и AKS
Основное руководство по Helm (v1.x) - базовая установка
Варианты развертывания (v2.x) - варианты развертывания v2.x
Руководство по обновлению - переход с v1.x на v2.x

Начало работы

Возможности

Управление ClickStack

Руководства

Партнёры по интеграции

Параметры развертывания Helm (v1.x)

Обзор

Внешний ClickHouse

Вариант 1: Встроенная конфигурация (для разработки/тестирования)

Вариант 2: Внешний секрет (рекомендуется для продакшена)

Создайте файлы конфигурации

Создайте секрет Kubernetes

Настройте Helm для использования секрета

Использование ClickHouse Cloud

Внешний OTEL collector

Минимальное развертывание

Следующие шаги

​Обзор

​Внешний ClickHouse

​Вариант 1: Встроенная конфигурация (для разработки/тестирования)

​Вариант 2: Внешний секрет (рекомендуется для продакшена)

​Создайте файлы конфигурации

​Создайте секрет Kubernetes

​Настройте Helm для использования секрета

​Использование ClickHouse Cloud

​Внешний OTEL collector

​Минимальное развертывание

​Следующие шаги

Обзор

Внешний ClickHouse

Вариант 1: Встроенная конфигурация (для разработки/тестирования)

Вариант 2: Внешний секрет (рекомендуется для продакшена)

Создайте файлы конфигурации

Создайте секрет Kubernetes

Настройте Helm для использования секрета

Использование ClickHouse Cloud

Внешний OTEL collector

Минимальное развертывание

Следующие шаги