Flux HelmRelease "values could not be rendered" in CI

By Daniel Zoghalchali·Latchkey

helm-controller assembles values from spec.values and spec.valuesFrom, then renders the chart with them. A referenced ConfigMap or Secret is missing, or the merged values produce a template error, so the release cannot be rendered.

What this error means

A HelmRelease reports "False" with a values-related error such as "could not resolve" a valuesFrom source, or a template failure caused by a bad value.

values could not be rendered: could not resolve reference: ConfigMap "web-values" not found

Common causes

A valuesFrom ConfigMap or Secret is missing

The HelmRelease references a valuesFrom source that does not exist in the namespace, so the values cannot be assembled.

The merged values break the chart template

A value has the wrong type or a required field is absent, so rendering the chart with the merged values fails.

How to fix it

Create the referenced values source

1. Create the ConfigMap or Secret named in valuesFrom in the release namespace.
2. Confirm the key referenced by valuesKey exists.
3. Reconcile the HelmRelease.

kubectl -n apps create configmap web-values --from-file=values.yaml
flux reconcile helmrelease web

Fix a values-driven template error

If rendering fails on a value, correct the type or add the required key in spec.values, then reconcile.

kubectl -n flux-system describe helmrelease web
flux logs --kind HelmRelease --name web

How to prevent it

• Create valuesFrom ConfigMaps and Secrets alongside the HelmRelease.
• Validate the merged values against the chart before applying.
• Keep required values explicit so a missing key fails clearly.

Frequently asked questions

Related guides

References

• Terraform documentation
• GitHub Actions documentation