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

Варианты развертывания с помощью 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  # 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: Внешний секрет (рекомендуется для production)​

Для production-развертываний, в которых вы хотите хранить учетные данные отдельно от конфигурации 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"

Полный пример подключения к ClickHouse Cloud см. в разделе "Создание подключения к ClickHouse Cloud".

Внешний 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

Дальнейшие шаги​