Skip to main content

gws generate-helm-values

Emit a known-good Helm values block for a common dev-mode dependency. Currently bundled charts: mysql, postgresql, redis, mongodb, rabbitmq, kafka (Bitnami).

Persistence is disabled in every bundled values file — these are dev defaults for ephemeral clusters, not production presets. Each bundled values file carries a header comment pinning the tested chart version and noting the persistence-disable key path so you can tweak it safely.

Used by the /gws-setup skill when it detects a project depends on a database, queue, or cache (via package deps, ORM configs, or .env keys) and needs to add a Helm dependency to gws.json.

Usage

gws generate-helm-values <chart> [options]
gws generate-helm-values --list
ArgumentDescription
chartOne of mysql, postgresql, redis, mongodb, rabbitmq, kafka. Run with --list to see the live list.
FlagDescriptionDefault
--format <yaml|json>yaml = raw values.yaml text. json = parsed object ready to merge under helm.values in gws.json.yaml
--name <svc>Substitute {{SERVICE_NAME}}.chart name
--listList supported charts as JSON.

Auth: not required.

Errors

CodeCause
EFRAMEWORK_NOT_TEMPLATEDUnknown chart, or no Helm templates bundled (shouldn't happen on a normal install). Shared with gws generate-template.
EUSAGEInvalid --format.

Examples

# Catalog
gws generate-helm-values --list

# Raw values.yaml — drop straight into a Helm release
gws generate-helm-values mysql > .gws/helm/mysql/values.yaml

# Object form — merge into gws.json under helm.values
gws generate-helm-values redis --format json --name cache | jq

# Pin a non-default service name
gws generate-helm-values postgresql --name primary-db

See also