Managing Releases
1. Listing Active Releases
| Command | Output |
|---|---|
helm list | Deployed releases in current namespace |
helm ls | Alias for list |
2. Listing All Releases
| Flag | Effect |
|---|---|
-a / --all | Include uninstalled + failed + pending |
--uninstalled | Show only uninstalled releases (kept history) |
--failed / --pending / --deployed | Status filters |
3. Filtering by Namespace
| Flag | Behavior |
|---|---|
-n <ns> | Single namespace |
--all-namespaces / -A | Cluster-wide |
4. Listing Across Namespaces
Example: Cluster-wide JSON list
helm list -A -o json | jq -r '.[] | "\(.namespace)/\(.name) \(.chart) \(.status)"'
5. Getting Release Status
| Command | Output |
|---|---|
helm status <name> | Current revision, status, NOTES.txt, resource list |
helm status <name> --show-resources | Include resource breakdown by kind |
6. Getting Release Values
Example: Inspect computed values
helm get values api # user-supplied only
helm get values api -a # all (defaults + user)
helm get values api -o json
7. Getting Release Manifest
| Command | Output |
|---|---|
helm get manifest api | Rendered YAML for current revision |
helm get manifest api --revision 3 | Specific historical revision |
8. Getting Release Notes
| Command | Output |
|---|---|
helm get notes api | Rendered NOTES.txt |
9. Getting Release Hooks
| Command | Output |
|---|---|
helm get hooks api | YAML of all hooks for revision |
helm get all api | Everything: manifest, hooks, notes, values |
10. Filtering Release Output
| Flag | Use |
|---|---|
-f <regex> / --filter | Regex on release name |
--selector key=value | Label selector on release |
-m / --max | Max number of releases |
--offset | Pagination offset |
--date | Sort by last-updated |
-r / --reverse | Reverse sort |