helm list

list releases

Synopsis

This command lists all of the releases.

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

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

If an argument 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 'ara[a-z]+'
  2. NAME UPDATED CHART
  3. maudlin-arachnid Mon May 9 16:07:08 2016 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] [FILTER]

Options

  1. -a, --all show all releases, not just the ones marked DEPLOYED
  2. -c, --chart-name sort by chart name
  3. --col-width uint specifies the max column width of output (default 60)
  4. -d, --date sort by release date
  5. --deleted show deleted releases
  6. --deleting show releases that are currently being deleted
  7. --deployed show deployed releases. If no other is specified, this will be automatically enabled
  8. --failed show failed releases
  9. -h, --help help for list
  10. -m, --max int maximum number of releases to fetch (default 256)
  11. --namespace string show releases within a specific namespace
  12. -o, --offset string next release name in the list, used to offset from start value
  13. --output string output the specified format (json or yaml)
  14. --pending show pending releases
  15. -r, --reverse reverse the sort order
  16. -q, --short output short (quiet) listing format
  17. --tls enable TLS for request
  18. --tls-ca-cert string path to TLS CA certificate file (default "$HELM-HOME/ca.pem")
  19. --tls-cert string path to TLS certificate file (default "$HELM-HOME/cert.pem")
  20. --tls-hostname string the server name used to verify the hostname on the returned certificates from the server
  21. --tls-key string path to TLS key file (default "$HELM-HOME/key.pem")
  22. --tls-verify enable TLS for request and verify remote

Options inherited from parent commands

  1. --debug enable verbose output
  2. --home string location of your Helm config. Overrides $HELM-HOME (default "~/.helm")
  3. --host string address of Tiller. Overrides $HELM-HOST
  4. --kube-context string name of the kubeconfig context to use
  5. --kubeconfig string absolute path to the kubeconfig file to use
  6. --tiller-connection-timeout int the duration (in seconds) Helm will wait to establish a connection to tiller (default 300)
  7. --tiller-namespace string namespace of Tiller (default "kube-system")

SEE ALSO

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