helm status: Command Reference for CI/CD

Inspect a release current state, revision, and resources.

helm status reports a release deployment status, its current revision, and the resources it manages. In CI it is the verification read after a deploy and a script-friendly source of the release state. This reference covers its flags.

Common flags and usage

• status <release>: show status, revision, and resources
• -o json|yaml: machine-readable output for CI assertions
• --revision N: show the status of a specific revision
• --show-resources: list the managed Kubernetes objects
• Pair with helm list to enumerate releases in a namespace

Example

STATE=$(helm status web -n prod -o json | jq -r '.info.status')
[ "$STATE" = "deployed" ] || { echo "release not deployed: $STATE"; exit 1; }

In CI

Assert on helm status -o json after a deploy to confirm the release reached the deployed state rather than failed or pending-upgrade. The JSON output is stable enough to parse with jq, making status the clean verification read at the end of a deploy job.

Key takeaways

• status -o json gives a parseable release state for CI assertions.
• A healthy release reports status "deployed", not pending or failed.
• --show-resources lists exactly what the release manages.

Related guides