#### Fixes
- Render templated per-node macros (`shard`, `replica`) in ClickHouse
`config.yaml` so multi-shard/multi-replica clusters get unique Keeper
paths instead of collisions
- Use the first TelemetryStore TCP address (not comma-joined) for
`SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_DSN` and ingester ClickHouse DSNs
#### Refactors
- `telemetrystore` molding now emits `config-{shard}-{replica}.yaml` per
node (mirrors `telemetrykeeper` per-replica pattern)
Related: https://github.com/SigNoz/platform-pod/issues/1332
Kubernetes with Helm
| Field | Value |
|---|---|
| Mode | kubernetes |
| Flavor | helm |
| Platform | - |
Overview
Generates a values.yaml for the SigNoz Helm chart. Foundry translates the casting spec into Helm values so you can deploy with a single helm install.
Prerequisites
- Kubernetes cluster (1.24+)
- Helm 3.x
- SigNoz Helm chart repo (
https://charts.signoz.io)
Configuration
apiVersion: v1alpha1
metadata:
name: signoz
spec:
deployment:
flavor: helm
mode: kubernetes
Deploy
foundryctl cast -f casting.yaml
Or step by step:
# Generate values.yaml
foundryctl forge -f casting.yaml
# Add the SigNoz Helm repo
helm repo add signoz https://charts.signoz.io
# Install with Helm
helm install signoz signoz/signoz -f pours/deployment/values.yaml -n signoz --create-namespace
Note
foundryctl castis idempotent. It detects whether a Helm release already exists and runshelm upgradeinstead ofhelm installaccordingly.
Generated output
pours/deployment/
values.yaml
After deployment
# Check pod status
kubectl get pods -n signoz
# Port-forward the SigNoz UI
kubectl port-forward svc/signoz -n signoz 8080:8080
Open http://localhost:8080 to access the SigNoz UI.
Customization
To set resource limits, storage classes, or scheduling constraints on the generated values.yaml, use patches. See the helm-patches example for a complete working configuration.
Annotations
Optional annotations to override the default Helm chart source. These are not required for standard deployments.
| Annotation | Default | Description |
|---|---|---|
foundry.signoz.io/kubernetes-helm-casting-chart |
signoz/signoz |
Helm chart reference |
foundry.signoz.io/kubernetes-helm-casting-repo-url |
https://charts.signoz.io |
Helm chart repository URL |
foundry.signoz.io/kubernetes-helm-casting-repo-name |
signoz |
Helm chart repository name |
foundry.signoz.io/kubernetes-helm-casting-forge-chart |
- | Set to true to download and bundle the chart locally during forge |
Example with a custom chart repo:
apiVersion: v1alpha1
metadata:
name: signoz
annotations:
foundry.signoz.io/kubernetes-helm-casting-repo-url: https://my-registry.example.com/charts
foundry.signoz.io/kubernetes-helm-casting-chart: my-registry/signoz
spec:
deployment:
flavor: helm
mode: kubernetes