> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Helm 배포 옵션 (v1.x)

> v1.x ClickStack Helm 차트의 고급 배포 구성

<Warning>
  **사용 중단 — v1.x 차트**

  이 페이지에서는 유지 관리 모드인 **v1.x** 인라인 템플릿 Helm 차트의 배포 옵션을 설명합니다. v2.x 차트는 [Helm 배포 옵션](/ko/clickstack/deployment/helm-deployment-options)을 참조하십시오. 마이그레이션 방법은 [업그레이드 가이드](/ko/clickstack/deployment/helm-upgrade)를 참조하십시오.
</Warning>

이 가이드에서는 Helm을 사용한 ClickStack의 고급 배포 옵션을 다룹니다. 기본 설치는 [기본 Helm 배포 가이드](/ko/clickstack/deployment/helm-v1)를 참조하십시오.

<div id="overview">
  ## 개요
</div>

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

* **전체 스택** (기본값) - 모든 구성 요소 포함
* **외부 ClickHouse** - 기존 ClickHouse 클러스터 사용
* **외부 OTel collector** - 기존 OTel 인프라 사용
* **최소 배포** - HyperDX만 포함하고, 나머지 종속성은 외부 서비스 사용

<div id="external-clickhouse">
  ## 외부 ClickHouse
</div>

기존 ClickHouse 클러스터(ClickHouse Cloud 포함)가 있으면 기본 제공 ClickHouse를 비활성화하고 외부 인스턴스에 연결할 수 있습니다.

<div id="external-clickhouse-inline">
  ### 옵션 1: 인라인 구성(개발/테스트)
</div>

빠른 테스트 또는 비프로덕션 환경에는 이 방식을 사용하세요:

```yaml theme={null}
# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # 내장 ClickHouse 비활성화

otel:
  clickhouseEndpoint: "tcp://your-clickhouse-server:9000"
  clickhousePrometheusEndpoint: "http://your-clickhouse-server:9363"  # 선택 사항

hyperdx:
  defaultConnections: |
    [
      {
        "name": "External ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]
```

다음 구성으로 설치하십시오:

```shell theme={null}
helm install my-clickstack clickstack/clickstack -f values-external-clickhouse.yaml
```

<div id="external-clickhouse-secret">
  ### 옵션 2: 외부 시크릿(프로덕션 권장)
</div>

프로덕션 배포에서 자격 증명을 Helm 구성과 분리해 관리하려는 경우:

<div id="create-configuration">
  #### 설정 파일 만들기
</div>

```bash theme={null}
# 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

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

<div id="create-kubernetes-secret">
  #### Kubernetes 시크릿 생성
</div>

```bash theme={null}
kubectl create secret generic hyperdx-external-config \
  --from-file=connections.json=connections.json \
  --from-file=sources.json=sources.json

# 로컬 파일 정리
rm connections.json sources.json
```

<div id="configure-helm-secret">
  #### Helm에서 시크릿을 사용하도록 구성하기
</div>

```yaml theme={null}
# values-external-clickhouse-secret.yaml
clickhouse:
  enabled: false

otel:
  clickhouseEndpoint: "tcp://your-clickhouse-server:9000"
  clickhousePrometheusEndpoint: "http://your-clickhouse-server:9363"

hyperdx:
  useExistingConfigSecret: true
  existingConfigSecret: "hyperdx-external-config"
  existingConfigConnectionsKey: "connections.json"
  existingConfigSourcesKey: "sources.json"
```

```shell theme={null}
helm install my-clickstack clickstack/clickstack -f values-external-clickhouse-secret.yaml
```

<div id="using-clickhouse-cloud">
  ### ClickHouse Cloud 사용
</div>

ClickHouse Cloud에서는 다음과 같습니다:

```yaml theme={null}
# 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"
```

<div id="external-otel-collector">
  ## 외부 OTEL Collector
</div>

기존 OTEL collector 인프라를 사용 중인 경우:

```yaml theme={null}
# values-external-otel.yaml
otel:
  enabled: false  # 내장 OTEL collector 비활성화

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

```shell theme={null}
helm install my-clickstack clickstack/clickstack -f values-external-otel.yaml
```

인그레스를 통해 OTel collector 엔드포인트를 노출하는 방법은 [Ingress Configuration](/ko/clickstack/deployment/helm-configuration-v1#otel-collector-ingress)을 참조하십시오.

<div id="minimal-deployment">
  ## 최소 배포
</div>

기존 인프라를 갖춘 조직에서는 HyperDX만 배포하세요:

```yaml theme={null}
# values-minimal.yaml
clickhouse:
  enabled: false

otel:
  enabled: false

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

  # 옵션 1: 인라인 (테스트용)
  defaultConnections: |
    [
      {
        "name": "External ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]

  # 옵션 2: 외부 시크릿 (프로덕션)
  # useExistingConfigSecret: true
  # existingConfigSecret: "my-external-config"
  # existingConfigConnectionsKey: "connections.json"
  # existingConfigSourcesKey: "sources.json"
```

```shell theme={null}
helm install my-clickstack clickstack/clickstack -f values-minimal.yaml
```

<div id="next-steps">
  ## 다음 단계
</div>

* [구성 가이드 (v1.x)](/ko/clickstack/deployment/helm-configuration-v1) - API Key, 시크릿, 인그레스 설정
* [Cloud 배포 (v1.x)](/ko/clickstack/deployment/helm-cloud-v1) - GKE, EKS, AKS별 구성
* [주요 Helm 가이드 (v1.x)](/ko/clickstack/deployment/helm-v1) - Basic 설치
* [배포 옵션 (v2.x)](/ko/clickstack/deployment/helm-deployment-options) - v2.x 배포 옵션
* [업그레이드 가이드](/ko/clickstack/deployment/helm-upgrade) - v1.x에서 v2.x로 마이그레이션