You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
helm/docs/man/man1/helm_list.1

152 lines
3.0 KiB

.TH "HELM" "1" "May 2017" "Auto generated by spf13/cobra" ""
.nh
.ad l
.SH NAME
.PP
helm\-list \- list releases
.SH SYNOPSIS
.PP
\fBhelm list [flags] [FILTER]\fP
.SH DESCRIPTION
.PP
This command lists all of the releases.
.PP
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'.
.PP
By default, items are sorted alphabetically. Use the '\-d' flag to sort by
release date.
.PP
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.
.PP
.RS
.nf
$ helm list 'ara[a\-z]+'
NAME UPDATED CHART
maudlin\-arachnid Mon May 9 16:07:08 2016 alpine\-0.1.0
.fi
.RE
.PP
If no results are found, 'helm list' will exit 0, but with no output (or in
the case of no '\-q' flag, only headers).
.PP
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.
.SH OPTIONS
.PP
\fB\-\-all\fP[=false]
show all releases, not just the ones marked DEPLOYED
.PP
\fB\-d\fP, \fB\-\-date\fP[=false]
sort by release date
.PP
\fB\-\-deleted\fP[=false]
show deleted releases
.PP
\fB\-\-deleting\fP[=false]
show releases that are currently being deleted
.PP
\fB\-\-deployed\fP[=false]
show deployed releases. If no other is specified, this will be automatically enabled
.PP
\fB\-\-failed\fP[=false]
show failed releases
.PP
\fB\-m\fP, \fB\-\-max\fP=256
maximum number of releases to fetch
.PP
\fB\-\-namespace\fP=""
show releases within a specific namespace
.PP
\fB\-o\fP, \fB\-\-offset\fP=""
next release name in the list, used to offset from start value
.PP
\fB\-r\fP, \fB\-\-reverse\fP[=false]
reverse the sort order
.PP
\fB\-q\fP, \fB\-\-short\fP[=false]
output short (quiet) listing format
.PP
\fB\-\-tls\fP[=false]
enable TLS for request
.PP
\fB\-\-tls\-ca\-cert\fP="$HELM\_HOME/ca.pem"
path to TLS CA certificate file
.PP
\fB\-\-tls\-cert\fP="$HELM\_HOME/cert.pem"
path to TLS certificate file
.PP
\fB\-\-tls\-key\fP="$HELM\_HOME/key.pem"
path to TLS key file
.PP
\fB\-\-tls\-verify\fP[=false]
enable TLS for request and verify remote
.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB\-\-debug\fP[=false]
enable verbose output
.PP
\fB\-\-home\fP="~/.helm"
location of your Helm config. Overrides $HELM\_HOME
.PP
\fB\-\-host\fP="localhost:44134"
address of tiller. Overrides $HELM\_HOST
.PP
\fB\-\-kube\-context\fP=""
name of the kubeconfig context to use
.PP
\fB\-\-tiller\-namespace\fP="kube\-system"
namespace of tiller
.SH SEE ALSO
.PP
\fBhelm(1)\fP
.SH HISTORY
.PP
19\-May\-2017 Auto generated by spf13/cobra