helm

The Helm package manager for Kubernetes.

Synopsis

The Kubernetes package manager

To begin working with Helm, run the ‘helm init’ command:

$ helm init

This will install Tiller to your running Kubernetes cluster. It will also set up any necessary local configuration.

Common actions from this point include:

  • helm search: search for charts
  • helm fetch: download a chart to your local directory to view
  • helm install: upload the chart to Kubernetes
  • helm list: list releases of charts

Environment: $HELM_HOME set an alternative location for Helm files. By default, these are stored in ~/.helm $HELM_HOST set an alternative Tiller host. The format is host:port $HELM_NO_PLUGINS disable plugins. Set HELM_NO_PLUGINS=1 to disable plugins. $TILLER_NAMESPACE set an alternative Tiller namespace (default “kube-system”) $KUBECONFIG set an alternative Kubernetes configuration file (default “~/.kube/config”)

Options

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 8-Aug-2017

helm completion

Generate autocompletions script for the specified shell (bash or zsh)

Synopsis

Generate autocompletions script for Helm for the specified shell (bash or zsh).

This command can generate shell autocompletions. e.g.

$ helm completion bash

Can be sourced as such

$ source <(helm completion bash)
helm completion SHELL

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm create

create a new chart with the given name

Synopsis

This command creates a chart directory along with the common files and directories used in a chart.

For example, ‘helm create foo’ will create a directory structure that looks something like this:

foo/
  |
  |- .helmignore   # Contains patterns to ignore when packaging Helm charts.
  |
  |- Chart.yaml    # Information about your chart
  |
  |- values.yaml   # The default values for your templates
  |
  |- charts/       # Charts that this chart depends on
  |
  |- templates/    # The template files

‘helm create’ takes a path for an argument. If directories in the given path do not exist, Helm will attempt to create them as it goes. If the given destination exists and there are files in that directory, conflicting files will be overwritten, but other files will be left alone.

helm create NAME

Options

  -p, --starter string   the named Helm starter scaffold

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm delete

given a release name, delete the release from Kubernetes

Synopsis

This command takes a release name, and then deletes the release from Kubernetes. It removes all of the resources associated with the last release of the chart.

Use the ‘–dry-run’ flag to see which releases will be deleted without actually deleting them.

helm delete [flags] RELEASE_NAME [...]

Options

      --dry-run              simulate a delete
      --no-hooks             prevent hooks from running during deletion
      --purge                remove the release from the store and make its name free for later use
      --timeout int          time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm dependency

manage a chart’s dependencies

Synopsis

Manage the dependencies of a chart.

Helm charts store their dependencies in ‘charts/’. For chart developers, it is often easier to manage a single dependency file (‘requirements.yaml’) which declares all dependencies.

The dependency commands operate on that file, making it easy to synchronize between the desired dependencies and the actual dependencies stored in the ‘charts/’ directory.

A ‘requirements.yaml’ file is a YAML file in which developers can declare chart dependencies, along with the location of the chart and the desired version. For example, this requirements file declares two dependencies:

# requirements.yaml
dependencies:
- name: nginx
  version: "1.2.3"
  repository: "https://example.com/charts"
- name: memcached
  version: "3.2.1"
  repository: "https://another.example.com/charts"

The ‘name’ should be the name of a chart, where that name must match the name in that chart’s ‘Chart.yaml’ file.

The ‘version’ field should contain a semantic version or version range.

The ‘repository’ URL should point to a Chart Repository. Helm expects that by appending ‘/index.yaml’ to the URL, it should be able to retrieve the chart repository’s index. Note: ‘repository’ can be an alias. The alias must start with ‘alias:’ or ‘@’.

Starting from 2.2.0, repository can be defined as the path to the directory of the dependency charts stored locally. The path should start with a prefix of “file://“. For example,

# requirements.yaml
dependencies:
- name: nginx
  version: "1.2.3"
  repository: "file://../dependency_chart/nginx"

If the dependency chart is retrieved locally, it is not required to have the repository added to helm by “helm add repo”. Version matching is also supported for this case.

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 11-Jul-2017

helm dependency build

rebuild the charts/ directory based on the requirements.lock file

Synopsis

Build out the charts/ directory from the requirements.lock file.

Build is used to reconstruct a chart’s dependencies to the state specified in the lock file. This will not re-negotiate dependencies, as ‘helm dependency update’ does.

If no lock file is found, ‘helm dependency build’ will mirror the behavior of ‘helm dependency update’.

helm dependency build [flags] CHART

Options

      --keyring string   keyring containing public keys (default "~/.gnupg/pubring.gpg")
      --verify           verify the packages against signatures

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm dependency list

list the dependencies for the given chart

Synopsis

List all of the dependencies declared in a chart.

This can take chart archives and chart directories as input. It will not alter the contents of a chart.

This will produce an error if the chart cannot be loaded. It will emit a warning if it cannot find a requirements.yaml.

helm dependency list [flags] CHART

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm dependency update

update charts/ based on the contents of requirements.yaml

Synopsis

Update the on-disk dependencies to mirror the requirements.yaml file.

This command verifies that the required charts, as expressed in ‘requirements.yaml’, are present in ‘charts/’ and are at an acceptable version. It will pull down the latest charts that satisfy the dependencies, and clean up old dependencies.

On successful update, this will generate a lock file that can be used to rebuild the requirements to an exact version.

Dependencies are not required to be represented in ‘requirements.yaml’. For that reason, an update command will not remove charts unless they are (a) present in the requirements.yaml file, but (b) at the wrong version.

helm dependency update [flags] CHART

Options

      --keyring string   keyring containing public keys (default "~/.gnupg/pubring.gpg")
      --skip-refresh     do not refresh the local repository cache
      --verify           verify the packages against signatures

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm fetch

download a chart from a repository and (optionally) unpack it in local directory

Synopsis

Retrieve a package from a package repository, and download it locally.

This is useful for fetching packages to inspect, modify, or repackage. It can also be used to perform cryptographic verification of a chart without installing the chart.

There are options for unpacking the chart after download. This will create a directory for the chart and uncompress into that directory.

If the –verify flag is specified, the requested chart MUST have a provenance file, and MUST pass the verification process. Failure in any part of this will result in an error, and the chart will not be saved locally.

helm fetch [flags] [chart URL | repo/chartname] [...]

Options

      --ca-file string       verify certificates of HTTPS-enabled servers using this CA bundle
      --cert-file string     identify HTTPS client using this SSL certificate file
  -d, --destination string   location to write the chart. If this and tardir are specified, tardir is appended to this (default ".")
      --devel                use development versions, too. Equivalent to version '>0.0.0-a'. If --version is set, this is ignored.
      --key-file string      identify HTTPS client using this SSL key file
      --keyring string       keyring containing public keys (default "~/.gnupg/pubring.gpg")
      --prov                 fetch the provenance file, but don't perform verification
      --repo string          chart repository url where to locate the requested chart
      --untar                if set to true, will untar the chart after downloading it
      --untardir string      if untar is specified, this flag specifies the name of the directory into which the chart is expanded (default ".")
      --verify               verify the package against its signature
      --version string       specific version of a chart. Without this, the latest version is fetched

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 17-Aug-2017

helm get

download a named release

Synopsis

This command shows the details of a named release.

It can be used to get extended information about the release, including:

  • The values used to generate the release
  • The chart used to generate the release
  • The generated manifest file

By default, this prints a human readable collection of information about the chart, the supplied values, and the generated manifest file.

helm get [flags] RELEASE_NAME

Options

      --revision int32       get the named release with revision
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm get hooks

download all hooks for a named release

Synopsis

This command downloads hooks for a given release.

Hooks are formatted in YAML and separated by the YAML ‘—\n’ separator.

helm get hooks [flags] RELEASE_NAME

Options

      --revision int32   get the named release with revision

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm get manifest

download the manifest for a named release

Synopsis

This command fetches the generated manifest for a given release.

A manifest is a YAML-encoded representation of the Kubernetes resources that were generated from this release’s chart(s). If a chart is dependent on other charts, those resources will also be included in the manifest.

helm get manifest [flags] RELEASE_NAME

Options

      --revision int32   get the named release with revision

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm get values

download the values file for a named release

Synopsis

This command downloads a values file for a given release.

helm get values [flags] RELEASE_NAME

Options

  -a, --all              dump all (computed) values
      --revision int32   get the named release with revision

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm history

fetch release history

Synopsis

History prints historical revisions for a given release.

A default maximum of 256 revisions will be returned. Setting ‘–max’ configures the maximum length of the revision list returned.

The historical release set is printed as a formatted table, e.g:

$ helm history angry-bird --max=4
REVISION   UPDATED                      STATUS           CHART        DESCRIPTION
1           Mon Oct 3 10:15:13 2016     SUPERSEDED      alpine-0.1.0  Initial install
2           Mon Oct 3 10:15:13 2016     SUPERSEDED      alpine-0.1.0  Upgraded successfully
3           Mon Oct 3 10:15:13 2016     SUPERSEDED      alpine-0.1.0  Rolled back to 2
4           Mon Oct 3 10:15:13 2016     DEPLOYED        alpine-0.1.0  Upgraded successfully
helm history [flags] RELEASE_NAME

Options

      --max int32            maximum number of revision to include in history (default 256)
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm home

displays the location of HELM_HOME

Synopsis

This command displays the location of HELM_HOME. This is where any helm configuration files live.

helm home

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm init

initialize Helm on both client and server

Synopsis

This command installs Tiller (the Helm server-side component) onto your Kubernetes Cluster and sets up local configuration in $HELM_HOME (default ~/.helm/).

As with the rest of the Helm commands, ‘helm init’ discovers Kubernetes clusters by reading $KUBECONFIG (default ‘~/.kube/config’) and using the default context.

To set up just a local environment, use ‘–client-only’. That will configure $HELM_HOME, but not attempt to connect to a Kubernetes cluster and install the Tiller deployment.

When installing Tiller, ‘helm init’ will attempt to install the latest released version. You can specify an alternative image with ‘–tiller-image’. For those frequently working on the latest code, the flag ‘–canary-image’ will install the latest pre-release version of Tiller (e.g. the HEAD commit in the GitHub repository on the master branch).

To dump a manifest containing the Tiller deployment YAML, combine the ‘–dry-run’ and ‘–debug’ flags.

helm init

Options

      --canary-image             use the canary Tiller image
  -c, --client-only              if set does not install Tiller
      --dry-run                  do not install local or remote
      --history-max int          limit the maximum number of revisions saved per release. Use 0 for no limit.
      --local-repo-url string    URL for local repository (default "http://127.0.0.1:8879/charts")
      --net-host                 install Tiller with net=host
      --service-account string   name of service account
      --skip-refresh             do not refresh (download) the local repository cache
      --stable-repo-url string   URL for stable repository (default "https://kubernetes-charts.storage.googleapis.com")
  -i, --tiller-image string      override Tiller image
      --tiller-tls               install Tiller with TLS enabled
      --tiller-tls-cert string   path to TLS certificate file to install with Tiller
      --tiller-tls-key string    path to TLS key file to install with Tiller
      --tiller-tls-verify        install Tiller with TLS enabled and to verify remote certificates
      --tls-ca-cert string       path to CA root certificate
      --upgrade                  upgrade if Tiller is already installed

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 10-Aug-2017

helm inspect

inspect a chart

Synopsis

This command inspects a chart and displays information. It takes a chart reference (‘stable/drupal’), a full path to a directory or packaged chart, or a URL.

Inspect prints the contents of the Chart.yaml file and the values.yaml file.

helm inspect [CHART]

Options

      --ca-file string     chart repository url where to locate the requested chart
      --cert-file string   verify certificates of HTTPS-enabled servers using this CA bundle
      --key-file string    identify HTTPS client using this SSL key file
      --keyring string     path to the keyring containing public verification keys (default "~/.gnupg/pubring.gpg")
      --repo string        chart repository url where to locate the requested chart
      --verify             verify the provenance data for this chart
      --version string     version of the chart. By default, the newest chart is shown

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm inspect chart

shows inspect chart

Synopsis

This command inspects a chart (directory, file, or URL) and displays the contents of the Charts.yaml file

helm inspect chart [CHART]

Options

      --ca-file string     chart repository url where to locate the requested chart
      --cert-file string   verify certificates of HTTPS-enabled servers using this CA bundle
      --key-file string    identify HTTPS client using this SSL key file
      --keyring string     path to the keyring containing public verification keys (default "~/.gnupg/pubring.gpg")
      --repo string        chart repository url where to locate the requested chart
      --verify             verify the provenance data for this chart
      --version string     version of the chart. By default, the newest chart is shown

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm inspect values

shows inspect values

Synopsis

This command inspects a chart (directory, file, or URL) and displays the contents of the values.yaml file

helm inspect values [CHART]

Options

      --ca-file string     chart repository url where to locate the requested chart
      --cert-file string   verify certificates of HTTPS-enabled servers using this CA bundle
      --key-file string    identify HTTPS client using this SSL key file
      --keyring string     path to the keyring containing public verification keys (default "~/.gnupg/pubring.gpg")
      --repo string        chart repository url where to locate the requested chart
      --verify             verify the provenance data for this chart
      --version string     version of the chart. By default, the newest chart is shown

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm install

install a chart archive

Synopsis

This command installs a chart archive.

The install argument must be a chart reference, a path to a packaged chart, a path to an unpacked chart directory or a URL.

To override values in a chart, use either the ‘–values’ flag and pass in a file or use the ‘–set’ flag and pass configuration from the command line.

$ helm install -f myvalues.yaml ./redis

or

$ helm install --set name=prod ./redis

You can specify the ‘–values’/‘-f’ flag multiple times. The priority will be given to the last (right-most) file specified. For example, if both myvalues.yaml and override.yaml contained a key called ‘Test’, the value set in override.yaml would take precedence:

$ helm install -f myvalues.yaml -f override.yaml ./redis

You can specify the ‘–set’ flag multiple times. The priority will be given to the last (right-most) set specified. For example, if both ‘bar’ and ‘newbar’ values are set for a key called ‘foo’, the ‘newbar’ value would take precedence:

$ helm install --set foo=bar --set foo=newbar ./redis

To check the generated manifests of a release without installing the chart, the ‘–debug’ and ‘–dry-run’ flags can be combined. This will still require a round-trip to the Tiller server.

If –verify is set, the chart MUST have a provenance file, and the provenenace fall MUST pass all verification steps.

There are four different ways you can express the chart you want to install:

  1. By chart reference: helm install stable/mariadb
  2. By path to a packaged chart: helm install ./nginx-1.2.3.tgz
  3. By path to an unpacked chart directory: helm install ./nginx
  4. By absolute URL: helm install https://example.com/charts/nginx-1.2.3.tgz

CHART REFERENCES

A chart reference is a convenient way of reference a chart in a chart repository.

When you use a chart reference (‘stable/mariadb’), Helm will look in the local configuration for a chart repository named ‘stable’, and will then look for a chart in that repository whose name is ‘mariadb’. It will install the latest version of that chart unless you also supply a version number with the ‘–version’ flag.

To see the list of chart repositories, use ‘helm repo list’. To search for charts in a repository, use ‘helm search’.

helm install [CHART]

Options

      --ca-file string         verify certificates of HTTPS-enabled servers using this CA bundle
      --cert-file string       identify HTTPS client using this SSL certificate file
      --devel                  use development versions, too. Equivalent to version '>0.0.0-a'. If --version is set, this is ignored.
      --dry-run                simulate an install
      --key-file string        identify HTTPS client using this SSL key file
      --keyring string         location of public keys used for verification (default "~/.gnupg/pubring.gpg")
  -n, --name string            release name. If unspecified, it will autogenerate one for you
      --name-template string   specify template used to name the release
      --namespace string       namespace to install the release into. Defaults to the current kube config namespace.
      --no-hooks               prevent hooks from running during install
      --replace                re-use the given name, even if that name is already used. This is unsafe in production
      --repo string            chart repository url where to locate the requested chart
      --set stringArray        set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
      --timeout int            time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
      --tls                    enable TLS for request
      --tls-ca-cert string     path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string        path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string         path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify             enable TLS for request and verify remote
  -f, --values valueFiles      specify values in a YAML file (can specify multiple) (default [])
      --verify                 verify the package before installing it
      --version string         specify the exact chart version to install. If this is not specified, the latest version is installed
      --wait                   if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as --timeout

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 15-Aug-2017

helm lint

examines a chart for possible issues

Synopsis

This command takes a path to a chart and runs a series of tests to verify that the chart is well-formed.

If the linter encounters things that will cause the chart to fail installation, it will emit [ERROR] messages. If it encounters issues that break with convention or recommendation, it will emit [WARNING] messages.

helm lint [flags] PATH

Options

      --strict   fail on lint warnings

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

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.

$ helm list 'ara[a-z]+'
NAME                UPDATED                     CHART
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.

helm list [flags] [FILTER]

Options

  -a, --all                  show all releases, not just the ones marked DEPLOYED
  -d, --date                 sort by release date
      --deleted              show deleted releases
      --deleting             show releases that are currently being deleted
      --deployed             show deployed releases. If no other is specified, this will be automatically enabled
      --failed               show failed releases
  -m, --max int              maximum number of releases to fetch (default 256)
      --namespace string     show releases within a specific namespace
  -o, --offset string        next release name in the list, used to offset from start value
      --pending              show pending releases
  -r, --reverse              reverse the sort order
  -q, --short                output short (quiet) listing format
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 12-Jul-2017

helm package

package a chart directory into a chart archive

Synopsis

This command packages a chart into a versioned chart archive file. If a path is given, this will look at that path for a chart (which must contain a Chart.yaml file) and then package that directory.

If no path is given, this will look in the present working directory for a Chart.yaml file, and (if found) build the current directory into a chart.

Versioned chart archives are used by Helm package repositories.

helm package [flags] [CHART_PATH] [...]

Options

  -u, --dependency-update    update dependencies from "requirements.yaml" to dir "charts/" before packaging
  -d, --destination string   location to write the chart. (default ".")
      --key string           name of the key to use when signing. Used if --sign is true
      --keyring string       location of a public keyring (default "~/.gnupg/pubring.gpg")
      --save                 save packaged chart to local chart repository (default true)
      --sign                 use a PGP private key to sign this package
      --version string       set the version on the chart to this semver version

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm plugin

add, list, or remove Helm plugins

Synopsis

Manage client-side Helm plugins.

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm plugin install

install one or more Helm plugins

Synopsis

install one or more Helm plugins

helm plugin install [options] <path|url>...

Options

      --version string   specify a version constraint. If this is not specified, the latest version is installed

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm plugin list

list installed Helm plugins

Synopsis

list installed Helm plugins

helm plugin list

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm plugin remove

remove one or more Helm plugins

Synopsis

remove one or more Helm plugins

helm plugin remove <plugin>...

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm plugin update

update one or more Helm plugins

Synopsis

update one or more Helm plugins

helm plugin update <plugin>...

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm repo

add, list, remove, update, and index chart repositories

Synopsis

This command consists of multiple subcommands to interact with chart repositories.

It can be used to add, remove, list, and index chart repositories. Example usage: $ helm repo add [NAME] [REPO_URL]

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

Auto generated by spf13/cobra on 23-Jun-2017

helm repo add

add a chart repository

Synopsis

add a chart repository

helm repo add [flags] [NAME] [URL]

Options

      --ca-file string     verify certificates of HTTPS-enabled servers using this CA bundle
      --cert-file string   identify HTTPS client using this SSL certificate file
      --key-file string    identify HTTPS client using this SSL key file
      --no-update          raise error if repo is already registered

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm repo - add, list, remove, update, and index chart repositories
Auto generated by spf13/cobra on 23-Jun-2017

helm repo index

generate an index file given a directory containing packaged charts

Synopsis

Read the current directory and generate an index file based on the charts found.

This tool is used for creating an ‘index.yaml’ file for a chart repository. To set an absolute URL to the charts, use ‘–url’ flag.

To merge the generated index with an existing index file, use the ‘–merge’ flag. In this case, the charts found in the current directory will be merged into the existing index, with local charts taking priority over existing charts.

helm repo index [flags] [DIR]

Options

      --merge string   merge the generated index into the given index
      --url string     url of chart repository

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm repo - add, list, remove, update, and index chart repositories
Auto generated by spf13/cobra on 23-Jun-2017

helm repo list

list chart repositories

Synopsis

list chart repositories

helm repo list [flags]

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm repo - add, list, remove, update, and index chart repositories
Auto generated by spf13/cobra on 23-Jun-2017

helm repo remove

remove a chart repository

Synopsis

remove a chart repository

helm repo remove [flags] [NAME]

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm repo - add, list, remove, update, and index chart repositories
Auto generated by spf13/cobra on 23-Jun-2017

helm repo update

update information of available charts locally from chart repositories

Synopsis

Update gets the latest information about charts from the respective chart repositories. Information is cached locally, where it is used by commands like ‘helm search’.

‘helm update’ is the deprecated form of ‘helm repo update’. It will be removed in future releases.

helm repo update

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm repo - add, list, remove, update, and index chart repositories
Auto generated by spf13/cobra on 23-Jun-2017

helm reset

uninstalls Tiller from a cluster

Synopsis

This command uninstalls Tiller (the Helm server-side component) from your Kubernetes Cluster and optionally deletes local configuration in $HELM_HOME (default ~/.helm/)

helm reset

Options

  -f, --force                forces Tiller uninstall even if there are releases installed, or if Tiller is not in ready state
      --remove-helm-home     if set deletes $HELM_HOME
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 27-Jun-2017

helm rollback

roll back a release to a previous revision

Synopsis

This command rolls back a release to a previous revision.

The first argument of the rollback command is the name of a release, and the second is a revision (version) number. To see revision numbers, run ‘helm history RELEASE’.

helm rollback [flags] [RELEASE] [REVISION]

Options

      --dry-run              simulate a rollback
      --force                force resource update through delete/recreate if needed
      --no-hooks             prevent hooks from running during rollback
      --recreate-pods        performs pods restart for the resource if applicable
      --timeout int          time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote
      --wait                 if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as --timeout

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

search for a keyword in charts

Synopsis

Search reads through all of the repositories configured on the system, and looks for matches.

Repositories are managed with ‘helm repo’ commands.

helm search [keyword]

Options

  -r, --regexp           use regular expressions for searching
  -v, --version string   search using semantic versioning constraints
  -l, --versions         show the long listing, with each version of each chart on its own line

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm serve

start a local http web server

Synopsis

This command starts a local chart repository server that serves charts from a local directory.

The new server will provide HTTP access to a repository. By default, it will scan all of the charts in ‘$HELM_HOME/repository/local’ and serve those over the local IPv4 TCP port (default ‘127.0.0.1:8879’).

This command is intended to be used for educational and testing purposes only. It is best to rely on a dedicated web server or a cloud-hosted solution like Google Cloud Storage for production use.

See https://github.com/kubernetes/helm/blob/master/docs/developing_charts.md#hosting-chart-repositories for more information on hosting chart repositories in a production setting.

helm serve

Options

      --address string     address to listen on (default "127.0.0.1:8879")
      --repo-path string   local directory path from which to serve charts
      --url string         external URL of chart repository

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm status

displays the status of the named release

Synopsis

This command shows the status of a named release. The status consists of: - last deployment time - k8s namespace in which the release lives - state of the release (can be: UNKNOWN, DEPLOYED, DELETED, SUPERSEDED, FAILED or DELETING) - list of resources that this release consists of, sorted by kind - details on last test suite run, if applicable - additional notes provided by the chart

helm status [flags] RELEASE_NAME

Options

      --revision int32       if set, display the status of the named release with revision
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm template

locally render templates

Synopsis

Render chart templates locally and display the output.

This does not require Tiller. However, any values that would normally be looked up or retrieved in-cluster will be faked locally. Additionally, none of the server-side testing of chart validity (e.g. whether an API is supported) is done.

To render just one template in a chart, use ‘-x’:

$ helm template mychart -x templates/deployment.yaml
helm template [flags] CHART

Options

  -x, --execute stringArray    only execute the given templates
      --kube-version string    override the Kubernetes version used as Capabilities.KubeVersion.Major/Minor (e.g. 1.7)
  -n, --name string            release name (default "RELEASE-NAME")
      --name-template string   specify template used to name the release
      --namespace string       namespace to install the release into
      --notes                  show the computed NOTES.txt file as well
      --set stringArray        set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
  -f, --values valueFiles      specify values in a YAML file (can specify multiple) (default [])

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

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

helm test

test a release

Synopsis

The test command runs the tests for a release.

The argument this command takes is the name of a deployed release. The tests to be run are defined in the chart that was installed.

helm test [RELEASE]

Options

      --cleanup              delete test pods upon completion
      --timeout int          time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm upgrade

upgrade a release

Synopsis

This command upgrades a release to a new version of a chart.

The upgrade arguments must be a release and chart. The chart argument can be either: a chart reference(‘stable/mariadb’), a path to a chart directory, a packaged chart, or a fully qualified URL. For chart references, the latest version will be specified unless the ‘–version’ flag is set.

To override values in a chart, use either the ‘–values’ flag and pass in a file or use the ‘–set’ flag and pass configuration from the command line.

You can specify the ‘–values’/‘-f’ flag multiple times. The priority will be given to the last (right-most) file specified. For example, if both myvalues.yaml and override.yaml contained a key called ‘Test’, the value set in override.yaml would take precedence:

$ helm upgrade -f myvalues.yaml -f override.yaml redis ./redis

You can specify the ‘–set’ flag multiple times. The priority will be given to the last (right-most) set specified. For example, if both ‘bar’ and ‘newbar’ values are set for a key called ‘foo’, the ‘newbar’ value would take precedence:

$ helm upgrade --set foo=bar --set foo=newbar redis ./redis
helm upgrade [RELEASE] [CHART]

Options

      --ca-file string       verify certificates of HTTPS-enabled servers using this CA bundle
      --cert-file string     identify HTTPS client using this SSL certificate file
      --devel                use development versions, too. Equivalent to version '>0.0.0-a'. If --version is set, this is ignored.
      --dry-run              simulate an upgrade
      --force                force resource update through delete/recreate if needed
  -i, --install              if a release by this name doesn't already exist, run an install
      --key-file string      identify HTTPS client using this SSL key file
      --keyring string       path to the keyring that contains public signing keys (default "~/.gnupg/pubring.gpg")
      --namespace string     namespace to install the release into (only used if --install is set). Defaults to the current kube config namespace
      --no-hooks             disable pre/post upgrade hooks
      --recreate-pods        performs pods restart for the resource if applicable
      --repo string          chart repository url where to locate the requested chart
      --reset-values         when upgrading, reset the values to the ones built into the chart
      --reuse-values         when upgrading, reuse the last release's values, and merge in any new values. If '--reset-values' is specified, this is ignored.
      --set stringArray      set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
      --timeout int          time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote
  -f, --values valueFiles    specify values in a YAML file (can specify multiple) (default [])
      --verify               verify the provenance of the chart before upgrading
      --version string       specify the exact chart version to use. If this is not specified, the latest version is used
      --wait                 if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as long as --timeout

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 15-Aug-2017

helm verify

verify that a chart at the given path has been signed and is valid

Synopsis

Verify that the given chart has a valid provenance file.

Provenance files provide crytographic verification that a chart has not been tampered with, and was packaged by a trusted provider.

This command can be used to verify a local chart. Several other commands provide ‘–verify’ flags that run the same validation. To generate a signed package, use the ‘helm package –sign’ command.

helm verify [flags] PATH

Options

      --keyring string   keyring containing public keys (default "~/.gnupg/pubring.gpg")

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017

helm version

print the client/server version information

Synopsis

Show the client and server versions for Helm and tiller.

This will print a representation of the client and server versions of Helm and Tiller. The output will look something like this:

Client: &version.Version{SemVer:“v2.0.0”, GitCommit:“ff52399e51bb880526e9cd0ed8386f6433b74da1”, GitTreeState:“clean”} Server: &version.Version{SemVer:“v2.0.0”, GitCommit:“b0c113dfb9f612a9add796549da66c0d294508a3”, GitTreeState:“clean”}

  • SemVer is the semantic version of the release.
  • GitCommit is the SHA for the commit that this version was built from.
  • GitTreeState is “clean” if there are no local code changes when this binary was built, and “dirty” if the binary was built from locally modified code.

To print just the client version, use ‘–client’. To print just the server version, use ‘–server’.

helm version

Options

  -c, --client               client version only
  -s, --server               server version only
      --short                print the version number
      --tls                  enable TLS for request
      --tls-ca-cert string   path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
      --tls-cert string      path to TLS certificate file (default "$HELM_HOME/cert.pem")
      --tls-key string       path to TLS key file (default "$HELM_HOME/key.pem")
      --tls-verify           enable TLS for request and verify remote

Options inherited from parent commands

      --debug                     enable verbose output
      --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
      --host string               address of Tiller. Overrides $HELM_HOST
      --kube-context string       name of the kubeconfig context to use
      --tiller-namespace string   namespace of Tiller (default "kube-system")

SEE ALSO

  • helm - The Helm package manager for Kubernetes.
Auto generated by spf13/cobra on 23-Jun-2017