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

# Opciones de implementación con Helm

> Configuraciones avanzadas de implementación de ClickStack con Helm

<Warning>
  **Versión 2.x del gráfico**

  Esta página documenta el **gráfico de Helm v2.x** basado en subgráficos. Si aún usas el gráfico v1.x con plantillas en línea, consulta [Opciones de implementación con Helm (v1.x)](/es/clickstack/deployment/helm-deployment-options-v1). Para ver los pasos de migración, consulta la [guía de actualización](/es/clickstack/deployment/helm-upgrade).
</Warning>

Esta guía cubre las opciones avanzadas de implementación de ClickStack con Helm. Para la instalación básica, consulta la [guía principal de implementación con Helm](/es/clickstack/deployment/helm).

<div id="overview">
  ## Descripción general
</div>

El gráfico de Helm de ClickStack admite varias configuraciones de implementación:

* **Pila completa** (predeterminada) — Incluye todos los componentes, gestionados por operadores
* **ClickHouse externo** — Usa un clúster de ClickHouse existente
* **OTel collector externo** — Usa infraestructura de OTel existente
* **Implementación mínima** — Solo HyperDX y dependencias externas

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

Si ya dispone de un clúster de ClickHouse (incluido ClickHouse Cloud), puede desactivar el ClickHouse integrado y conectarse a su instancia externa.

<div id="external-clickhouse-inline">
  ### Opción 1: Configuración inline (desarrollo/pruebas)
</div>

Use este enfoque para pruebas rápidas o entornos no productivos. Proporcione los detalles de conexión mediante `hyperdx.config` y `hyperdx.secrets`:

```yaml theme={null}
# values-external-clickhouse.yaml
clickhouse:
  enabled: false  # Deshabilitar el ClickHouse gestionado por el operador

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 con esta configuración:

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

<div id="external-clickhouse-secret">
  ### Opción 2: Secreto externo (recomendado para producción)
</div>

Para despliegues de producción en los que quieras mantener las credenciales separadas de la configuración de Helm:

<div id="create-configuration">
  #### Cree los archivos de configuración
</div>

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

# Crear 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">
  #### Cree el secreto de Kubernetes
</div>

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

# Eliminar archivos locales
rm connections.json sources.json
```

<div id="configure-helm-secret">
  #### Configura Helm para usar el secreto
</div>

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

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">
  ### Uso de ClickHouse Cloud
</div>

En el caso de ClickHouse Cloud:

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

<div id="external-otel-collector">
  ## OTel collector externo
</div>

Si ya cuenta con una infraestructura de OTel collector, desactive el subgráfico:

```yaml theme={null}
# values-external-otel.yaml
otel-collector:
  enabled: false  # Deshabilitar el subgráfico del OTel collector

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

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

Para obtener instrucciones sobre cómo exponer los endpoints del OTel collector mediante Ingreso, consulta [Configuración de Ingreso](/es/clickstack/deployment/helm-configuration#otel-collector-ingress).

<div id="minimal-deployment">
  ## Implementación mínima
</div>

Para las organizaciones que ya cuentan con infraestructura, implemente solo HyperDX:

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

otel-collector:
  enabled: false

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

  # Opción 1: Inline (para pruebas)
  defaultConnections: |
    [
      {
        "name": "External ClickHouse",
        "host": "http://your-clickhouse-server:8123",
        "port": 8123,
        "username": "your-username",
        "password": "your-password"
      }
    ]

  # Opción 2: Secreto externo (producción)
  # 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">
  ## Próximos pasos
</div>

* [Guía de configuración](/es/clickstack/deployment/helm-configuration) - Configuración de claves API, secretos e Ingreso
* [Implementaciones en Cloud](/es/clickstack/deployment/helm-cloud) - Configuraciones específicas de GKE, EKS y AKS
* [Guía de actualización](/es/clickstack/deployment/helm-upgrade) - Migración de v1.x a v2.x
* [Manifiestos adicionales](/es/clickstack/deployment/helm-additional-manifests) - Objetos personalizados de Kubernetes
* [Guía principal de Helm](/es/clickstack/deployment/helm) - Instalación básica
* [Opciones de implementación (v1.x)](/es/clickstack/deployment/helm-deployment-options-v1) - Opciones de implementación para v1.x