Helm List

helm list

list releases

Synopsis

This command lists all of the releases for a specified namespace (uses current namespace context if namespace not specified).

By default, it lists only releases that are deployed or failed. Flags like ‘—uninstalled’ and ‘—all’ will alter this behavior. Such flags can be combined: ‘—uninstalled —failed’.

By default, items are sorted alphabetically. Use the ‘-d’ flag to sort by release date.

If the —filter flag is provided, it will be treated as a filter. Filters are regular expressions (Perl compatible) that are applied to the list of releases. Only items that match the filter will be returned.

  1. $ helm list --filter 'ara[a-z]+'
  2. NAME UPDATED CHART
  3. maudlin-arachnid 2020-06-18 14:17:46.125134977 +0000 UTC alpine-0.1.0

If no results are found, ‘helm list’ will exit 0, but with no output (or in the case of no ‘-q’ flag, only headers).

By default, up to 256 items may be returned. To limit this, use the ‘—max’ flag. Setting ‘—max’ to 0 will not return all results. Rather, it will return the server’s default, which may be much higher than 256. Pairing the ‘—max’ flag with the ‘—offset’ flag allows you to page through results.

  1. helm list [flags]

Options

  1. -a, --all show all releases without any filter applied
  2. -A, --all-namespaces list releases across all namespaces
  3. -d, --date sort by release date
  4. --deployed show deployed releases. If no other is specified, this will be automatically enabled
  5. --failed show failed releases
  6. -f, --filter string a regular expression (Perl compatible). Any releases that match the expression will be included in the results
  7. -h, --help help for list
  8. -m, --max int maximum number of releases to fetch (default 256)
  9. --no-headers don't print headers when using the default output format
  10. --offset int next release index in the list, used to offset from start value
  11. -o, --output format prints the output in the specified format. Allowed values: table, json, yaml (default table)
  12. --pending show pending releases
  13. -r, --reverse reverse the sort order
  14. -l, --selector string Selector (label query) to filter on, supports '=', '==', and '!='.(e.g. -l key1=value1,key2=value2). Works only for secret(default) and configmap storage backends.
  15. -q, --short output short (quiet) listing format
  16. --superseded show superseded releases
  17. --time-format string format time using golang time formatter. Example: --time-format "2006-01-02 15:04:05Z0700"
  18. --uninstalled show uninstalled releases (if 'helm uninstall --keep-history' was used)
  19. --uninstalling show releases that are currently being uninstalled

Options inherited from parent commands

  1. --burst-limit int client-side default throttling limit (default 100)
  2. --debug enable verbose output
  3. --kube-apiserver string the address and the port for the Kubernetes API server
  4. --kube-as-group stringArray group to impersonate for the operation, this flag can be repeated to specify multiple groups.
  5. --kube-as-user string username to impersonate for the operation
  6. --kube-ca-file string the certificate authority file for the Kubernetes API server connection
  7. --kube-context string name of the kubeconfig context to use
  8. --kube-insecure-skip-tls-verify if true, the Kubernetes API server's certificate will not be checked for validity. This will make your HTTPS connections insecure
  9. --kube-tls-server-name string server name to use for Kubernetes API server certificate validation. If it is not provided, the hostname used to contact the server is used
  10. --kube-token string bearer token used for authentication
  11. --kubeconfig string path to the kubeconfig file
  12. -n, --namespace string namespace scope for this request
  13. --qps float32 queries per second used when communicating with the Kubernetes API, not including bursting
  14. --registry-config string path to the registry config file (default "~/.config/helm/registry/config.json")
  15. --repository-cache string path to the directory containing cached repository indexes (default "~/.cache/helm/repository")
  16. --repository-config string path to the file containing repository names and URLs (default "~/.config/helm/repositories.yaml")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 11-Sep-2024