Helm 배포 옵션

이 가이드는 Helm을 사용한 ClickStack의 고급 배포 옵션을 다룹니다. 기본 설치는 Helm 기본 배포 가이드를 참고하십시오.

개요

ClickStack의 Helm 차트는 여러 배포 구성을 지원합니다:

• 풀 스택(기본값) - 모든 구성 요소 포함
• 외부 ClickHouse - 기존 ClickHouse 클러스터 사용
• 외부 OTel collector - 기존 OTel 인프라 사용
• 최소 배포 - HyperDX만 포함하고, 외부 종속성 사용

External ClickHouse

기존에 ClickHouse 클러스터(ClickHouse Cloud 포함)가 있는 경우, 내장 ClickHouse를 비활성화하고 외부 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: 외부 시크릿(운영 환경 권장)

운영 환경에 배포할 때 자격 증명을 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

다음 단계

• 구성 가이드 - API 키, 시크릿, 인그레스 설정
• Cloud 배포 - GKE, EKS, AKS별 구성
• 기본 Helm 가이드 - 기본 설치