# Helm Chart

The Spice.ai Enterprise Helm chart deploys the Spice runtime as a Kubernetes `Deployment` or `StatefulSet` with a `ConfigMap`-mounted Spicepod configuration.

## Install

```bash
helm install spiceai deploy/chart \
  --set spicepod.name=my-app
```

## Values Reference

| Parameter                                | Description                                       | Default                                                                         |
| ---------------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------- |
| `image.repository`                       | Container image repository                        | `709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/spiceai-enterprise-byol` |
| `image.tag`                              | Container image tag                               | `latest-models`                                                                 |
| `replicaCount`                           | Number of replicas                                | `1`                                                                             |
| `serviceAccount.create`                  | Create a `ServiceAccount`                         | `false`                                                                         |
| `serviceAccount.name`                    | `ServiceAccount` name                             | —                                                                               |
| `serviceAccount.annotations`             | Annotations for the `ServiceAccount`              | `{}`                                                                            |
| `service.type`                           | Kubernetes Service type                           | —                                                                               |
| `service.additionalAnnotations`          | Annotations for the Service                       | `{}`                                                                            |
| `stateful.enabled`                       | Use a `StatefulSet` with PVC                      | `false`                                                                         |
| `stateful.storageClass`                  | `StorageClass` for `StatefulSet` PVC              | `standard`                                                                      |
| `stateful.size`                          | PVC size                                          | `1Gi`                                                                           |
| `stateful.mountPath`                     | Mount path in container                           | `/data`                                                                         |
| `monitoring.podMonitor.enabled`          | Create a `PodMonitor` for Prometheus              | `false`                                                                         |
| `monitoring.podMonitor.additionalLabels` | Labels for the `PodMonitor`                       | `{}`                                                                            |
| `additionalLabels`                       | Labels added to all resources                     | `{}`                                                                            |
| `additionalEnv`                          | Extra environment variables                       | `[]`                                                                            |
| `resources`                              | CPU/memory requests and limits                    | `{}`                                                                            |
| `volumes`                                | Additional volumes                                | `[]`                                                                            |
| `volumeMounts`                           | Additional volume mounts                          | `[]`                                                                            |
| `spicepod`                               | Spicepod configuration (inlined into `ConfigMap`) | —                                                                               |

## Spicepod Configuration

The Spicepod spec is inlined directly in the Helm values and mounted as a `ConfigMap`:

```yaml
spicepod:
  name: my-app
  version: v1
  kind: Spicepod
  datasets:
    - from: s3://my-bucket/data/
      name: my_data
      params:
        file_format: parquet
      acceleration:
        enabled: true
        engine: duckdb
```

## StatefulSet with Persistent Storage

Enable a `StatefulSet` with a `PersistentVolumeClaim` for durable storage:

```yaml
stateful:
  enabled: true
  storageClass: gp3
  size: 50Gi
  mountPath: /data
```

## Resource Limits

```yaml
resources:
  requests:
    cpu: 200m
    memory: 1Gi
  limits:
    cpu: "2"
    memory: 4Gi
```

## Prometheus Monitoring

```yaml
monitoring:
  podMonitor:
    enabled: true
    additionalLabels:
      release: prometheus
```

## ServiceAccount for Cloud IAM

### AWS IRSA (EKS)

```yaml
serviceAccount:
  create: true
  name: spiceai
  annotations:
    eks.amazonaws.com/role-arn: arn:aws:iam::123456789012:role/my-spice-role
```

### GKE Workload Identity

```yaml
serviceAccount:
  create: true
  annotations:
    iam.gke.io/gcp-service-account: my-gcp-sa@my-project.iam.gserviceaccount.com
```

### Azure Workload Identity (AKS)

```yaml
serviceAccount:
  create: true
  annotations:
    azure.workload.identity/client-id: <AZURE_CLIENT_ID>
```