Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Implantações em Cloud com Helm (v1.x)

View as MarkdownEdit this pageReport an issueSet up docs MCP

Este guia aborda configurações específicas de Cloud para implantar o ClickStack em serviços gerenciados do Kubernetes. Para a instalação básica, consulte o guia principal de implantação com Helm.

Google Kubernetes Engine (GKE)

Ao implantar no GKE, pode ser necessário sobrescrever alguns valores devido ao comportamento de rede específico do provedor de nuvem.

Problema de resolução de DNS do LoadBalancer

O serviço LoadBalancer do GKE pode causar problemas internos de resolução de DNS, em que a comunicação entre pods passa a resolver para IPs externos em vez de permanecer dentro da rede do cluster. Isso afeta especificamente a conexão do OTel collector com o servidor OpAMP.

Sintomas:

  • logs do OTel collector mostrando erros de "connection refused" com endereços IP do cluster
  • Falhas de conexão com o OpAMP, como: dial tcp 34.118.227.30:4320: connect: connection refused

Solução:

Use o nome de domínio totalmente qualificado (FQDN) na URL do servidor 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"

Outras considerações sobre o GKE

# values-gke.yaml
hyperdx:
  frontendUrl: "http://34.123.61.99"  # Use o IP externo do seu LoadBalancer

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

# Ajuste para a rede de pods do GKE, se necessário
clickhouse:
  config:
    clusterCidrs:
      - "10.8.0.0/16"  # O GKE geralmente usa este intervalo
      - "10.0.0.0/8"   # Fallback para outras configurações

Amazon EKS

Para implantações no Amazon EKS, considere estas configurações comuns:

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

# EKS normalmente usa estes CIDRs de pod
clickhouse:
  config:
    clusterCidrs:
      - "192.168.0.0/16"
      - "10.0.0.0/8"

# Habilitar entrada para produção
hyperdx:
  ingress:
    enabled: true
    host: "hyperdx.yourdomain.com"
    tls:
      enabled: true

Azure AKS

Para implantações no AKS:

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

# Rede de pods do AKS
clickhouse:
  config:
    clusterCidrs:
      - "10.244.0.0/16"  # CIDR de pod comum do AKS
      - "10.0.0.0/8"

Checklist de implantação em produção no Cloud

Antes de implantar o ClickStack em produção em qualquer provedor de nuvem:

  • Configure corretamente o frontendUrl com seu domínio ou IP externo
  • Configure a Entrada com TLS para acesso via HTTPS
  • Substitua otel.opampServerUrl por um FQDN se estiver enfrentando problemas de conexão (especialmente no GKE)
  • Ajuste clickhouse.config.clusterCidrs para o CIDR da sua rede de pods
  • Configure armazenamento persistente para workloads de produção
  • Defina requisições e limites de recursos adequados
  • Habilite monitoramento e alertas
  • Configure backup e recuperação de desastres
  • Implemente um gerenciamento adequado de segredos

Boas práticas de produção

Gerenciamento de recursos

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

Alta disponibilidade

hyperdx:
  replicaCount: 3

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

Armazenamento persistente

Certifique-se de que os volumes persistentes estejam configurados para retenção de dados:

clickhouse:
  persistence:
    enabled: true
    size: 100Gi
    storageClass: "fast-ssd"  # Use a classe de armazenamento específica do provedor de cloud

Classes de armazenamento específicas para Cloud:

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

Observações sobre compatibilidade com navegadores

Para implantações com apenas HTTP (desenvolvimento/teste), alguns navegadores podem exibir erros da API de criptografia devido aos requisitos de contexto seguro. Para implantações de produção, sempre use HTTPS com certificados TLS adequados por meio da configuração de Entrada.

Consulte configuração de Entrada para ver as instruções de configuração de TLS.

Próximos passos

Navigation