# Helm Chart

#kubernetes #deployment #słownik

## Co to jest?

**Helm** to package manager dla Kubernetes. **Helm Chart** to paczka szablonów Kubernetes YAML z parametryzacją (values).

## Analogia

```
apt install nginx     →  helm install sympozium sympozium/sympozium
apt-get update        →  helm repo update
dpkg -l               →  helm list
```

## Struktura

```
charts/sympozium/
├── Chart.yaml          # Metadata (nazwa, wersja)
├── values.yaml         # Domyślne parametry
├── templates/          # Szablony K8s YAML
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── configmap.yaml
│   └── ...
└── charts/             # Sub-charts (zależności)
```

## values.yaml

```yaml
# Przykładowe parametry
controller:
  replicas: 1
  image:
    repository: ghcr.io/sympozium-ai/sympozium/controller
    tag: v0.0.25
  resources:
    requests:
      cpu: 250m
      memory: 512Mi

agentSandbox:
  enabled: true
  defaultRuntimeClass: gvisor

observability:
  enabled: true
  otlpEndpoint: "otel-collector:4317"
```

## Użycie w Sympozium

Sympozium instalowane via Helm:
```bash
helm repo add sympozium https://deploy.sympozium.ai/charts
helm install sympozium sympozium/sympozium
```

Chart zawiera:
- Controller Manager [[Deployment]]
- API Server Deployment
- Webhook Deployment + cert-manager integration
- NATS [[StatefulSet]]
- [[CRD - Custom Resource Definition|CRD]] manifests
- [[RBAC]] (ClusterRole, bindings)
- [[NetworkPolicy]] templates
- Built-in [[PersonaPack|PersonaPacks]] i [[SkillPack|SkillPacks]]

---

Powiązane: [[Struktura repozytorium]] | [[CRD - Custom Resource Definition]] | [[Control Plane]]