mirror of https://github.com/hanzoai/o11y-foundry.git synced 2026-10-30 18:26:45 +00:00

Files

T

NageshbansalandGitHub 6d50edd33d docs: fix broken links in docs (#91 )

#### Chores

- Fix Broken Links for `patches.md` in casting docs

Related: https://github.com/SigNoz/foundry/issues/90

2026-04-04 14:50:50 +00:00

2.5 KiB

Raw Permalink Blame History

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 cast is idempotent. It detects whether a Helm release already exists and runs helm upgrade instead of helm install accordingly.

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

2.5 KiB Raw Permalink Blame History