Перейти к основному содержимому
Перейти к основному содержимому

Варианты развертывания с Helm

Версия чарта 2.x

На этой странице описывается Helm-чарт v2.x на основе субчартов. Если вы всё ещё используете чарт v1.x со встроенными шаблонами, см. варианты развертывания с Helm (v1.x). Инструкции по миграции см. в руководстве по обновлению.

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

Обзор​

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

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

Внешний ClickHouse​

Если у вас уже есть кластер ClickHouse (включая ClickHouse Cloud), вы можете отключить встроенный ClickHouse и подключиться к внешнему экземпляру 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

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