Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Облачные развертывания Helm (v1.x)

View as MarkdownEdit this pageReport an issueSet up docs MCP

В этом руководстве рассматриваются конфигурации для Cloud при развертывании ClickStack в управляемых Kubernetes-сервисах. Базовую установку см. в основном руководстве по развертыванию Helm.

Google Kubernetes Engine (GKE)

При развертывании в GKE может потребоваться переопределить некоторые значения из-за особенностей работы сети в облачной среде.

Проблема с DNS-разрешением LoadBalancer

Сервис LoadBalancer в GKE может вызывать проблемы с внутренним DNS-разрешением: трафик между подами может направляться на внешние IP-адреса вместо того, чтобы оставаться внутри сети кластера. Это особенно влияет на подключение OTel collector к серверу OpAMP.

Симптомы:

  • В журналах OTel collector появляются ошибки "connection refused" с IP-адресами кластера
  • Сбои подключения к OpAMP, например: dial tcp 34.118.227.30:4320: connect: connection refused

Решение:

Используйте полное доменное имя (FQDN) для URL-адреса сервера OpAMP:

helm install my-clickstack clickstack/clickstack \
  --set hyperdx.frontendUrl="http://your-external-ip-or-domain.com" \
  --set otel.opampServerUrl="http://my-clickstack-clickstack-app.default.svc.cluster.local:4320"

Дополнительные аспекты GKE

# values-gke.yaml
hyperdx:
  frontendUrl: "http://34.123.61.99"  # Укажите внешний IP-адрес вашего LoadBalancer

otel:
  opampServerUrl: "http://my-clickstack-clickstack-app.default.svc.cluster.local:4320"

# При необходимости настройте сетевое взаимодействие подов GKE
clickhouse:
  config:
    clusterCidrs:
      - "10.8.0.0/16"  # Этот диапазон часто используется в GKE
      - "10.0.0.0/8"   # Резервный вариант для других конфигураций

Amazon EKS

Для развертывания в EKS рассмотрите следующие распространенные конфигурации:

# values-eks.yaml
hyperdx:
  frontendUrl: "http://your-alb-domain.com"

# EKS обычно использует следующие CIDR-диапазоны подов
clickhouse:
  config:
    clusterCidrs:
      - "192.168.0.0/16"
      - "10.0.0.0/8"

# Включить входной шлюз для продакшн-среды
hyperdx:
  ingress:
    enabled: true
    host: "hyperdx.yourdomain.com"
    tls:
      enabled: true

Azure AKS

Для развертываний в AKS:

# values-aks.yaml
hyperdx:
  frontendUrl: "http://your-azure-lb.com"

# Сетевые настройки подов AKS
clickhouse:
  config:
    clusterCidrs:
      - "10.244.0.0/16"  # Стандартный CIDR подов AKS
      - "10.0.0.0/8"

Контрольный список развертывания в production в Cloud

Перед развертыванием ClickStack в production у любого облачного провайдера:

  • Настройте корректный frontendUrl с вашим внешним доменом или IP-адресом
  • Настройте входной шлюз с TLS для доступа по HTTPS
  • Переопределите otel.opampServerUrl, указав FQDN, если возникают проблемы с подключением (особенно в GKE)
  • Скорректируйте clickhouse.config.clusterCidrs в соответствии с CIDR вашей сети подов
  • Настройте постоянное хранилище для production-нагрузок
  • Установите подходящие запросы и лимиты ресурсов
  • Включите мониторинг и оповещения
  • Настройте резервное копирование и аварийное восстановление
  • Реализуйте надлежащее управление секретами

Рекомендации для production-среды

Управление ресурсами

hyperdx:
  resources:
    requests:
      cpu: 500m
      memory: 1Gi
    limits:
      cpu: 2000m
      memory: 4Gi

Высокая доступность

hyperdx:
  replicaCount: 3

  affinity:
    podAntiAffinity:
      preferredDuringSchedulingIgnoredDuringExecution:
        - weight: 100
          podAffinityTerm:
            labelSelector:
              matchExpressions:
                - key: app.kubernetes.io/name
                  operator: In
                  values:
                    - clickstack
            topologyKey: kubernetes.io/hostname

Постоянное хранилище

Убедитесь, что постоянные тома настроены для сохранения данных:

clickhouse:
  persistence:
    enabled: true
    size: 100Gi
    storageClass: "fast-ssd"  # Укажите класс хранилища для вашего облачного провайдера

Классы хранилищ для Cloud:

  • GKE: pd-ssd или pd-balanced
  • EKS: gp3 или io2
  • AKS: managed-premium или managed-csi

Примечания о совместимости с браузерами

При развертывании только по HTTP (разработка/тестирование) в некоторых браузерах могут возникать ошибки Crypto API из-за требований к безопасному контексту. В рабочей среде всегда используйте HTTPS с корректными TLS-сертификатами, настроенными через входной шлюз.

Инструкции по настройке TLS см. в разделе Конфигурация входного шлюза.

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

Navigation