Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Opções de implantação com Helm

View as MarkdownEdit this pageReport an issueSet up docs MCP

Este guia aborda opções avançadas de implantação do ClickStack com Helm. Para uma instalação básica, consulte o guia principal de implantação com Helm.

Visão geral

O chart do Helm do ClickStack oferece suporte a várias configurações de implantação:

  • Stack completa (padrão) — Todos os componentes incluídos, gerenciados por operadores
  • ClickHouse externo — Use um cluster ClickHouse existente
  • OTel collector externo — Use a infraestrutura OTel existente
  • Implantação mínima — Apenas o HyperDX, com dependências externas

ClickHouse externo

Se você já tiver um cluster do ClickHouse (incluindo o ClickHouse Cloud), poderá desativar o ClickHouse integrado e se conectar à sua instância externa.

Opção 1: Configuração inline (desenvolvimento/testes)

Use esta abordagem para testes rápidos ou ambientes não produtivos. Forneça os detalhes de conexão por meio de hyperdx.config e hyperdx.secrets:

# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # Desabilita o ClickHouse gerenciado pelo operator

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"
      }
    ]

Instale com esta configuração:

helm install my-clickstack clickstack/clickstack -f values-external-clickhouse.yaml

Opção 2: Secret externo (recomendado para produção)

Para implantações em produção em que você queira manter as credenciais separadas da configuração do Helm:

Crie seus arquivos de configuração

# Criar 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

# Criar 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

Crie o Secret no Kubernetes

kubectl create secret generic hyperdx-external-config \
  --from-file=connections.json=connections.json \
  --from-file=sources.json=sources.json

# Remover arquivos locais
rm connections.json sources.json

Configure o Helm para usar o Secret

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

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

Como usar o ClickHouse Cloud

Especificamente no 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 externo

Se você já tiver uma infraestrutura de OTel collector existente, desative o subchart:

# values-external-otel.yaml
otel-collector:
  enabled: false  # Desabilitar o OTel collector do subchart

hyperdx:
  otelExporterEndpoint: "http://your-otel-collector:4318"
helm install my-clickstack clickstack/clickstack -f values-external-otel.yaml

Para obter instruções sobre como expor os endpoints do OTel collector por meio de uma Entrada, consulte Configuração de Entrada.

Implantação mínima

Para organizações com infraestrutura existente, implante apenas o HyperDX:

# values-minimal.yaml
clickhouse:
  enabled: false

otel-collector:
  enabled: false

hyperdx:
  otelExporterEndpoint: "http://your-otel-collector:4318"

  # Opção 1: Inline (para testes)
  defaultConnections: |
    [
      {
        "name": "External ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]

  # Opção 2: Secret externo (produção)
  # useExistingConfigSecret: true
  # existingConfigSecret: "my-external-config"
  # existingConfigConnectionsKey: "connections.json"
  # existingConfigSourcesKey: "sources.json"
helm install my-clickstack clickstack/clickstack -f values-minimal.yaml

Próximos passos

Navigation