github.com/cloudposse/helm@v2.2.3+incompatible/docs/helm/helm_install.md (about)

     1  ## helm install
     2  
     3  install a chart archive
     4  
     5  ### Synopsis
     6  
     7  
     8  
     9  This command installs a chart archive.
    10  
    11  The install argument must be either a relative path to a chart directory or the
    12  name of a chart in the current working directory.
    13  
    14  To override values in a chart, use either the '--values' flag and pass in a file
    15  or use the '--set' flag and pass configuration from the command line.
    16  
    17  	$ helm install -f myvalues.yaml ./redis
    18  
    19  or
    20  
    21  	$ helm install --set name=prod ./redis
    22  
    23  You can specify the '--values'/'-f' flag multiple times. The priority will be given to the
    24  last (right-most) file specified. For example, if both myvalues.yaml and override.yaml
    25  contained a key called 'Test', the value set in override.yaml would take precedence:
    26  
    27  	$ helm install -f myvalues.yaml -f override.yaml ./redis
    28  
    29  You can specify the '--set' flag multiple times. The priority will be given to the
    30  last (right-most) set specified. For example, if both 'bar' and 'newbar' values are
    31  set for a key called 'foo', the 'newbar' value would take precedence:
    32  
    33  	$ helm install --set foo=bar --set foo=newbar ./redis
    34  
    35  
    36  To check the generated manifests of a release without installing the chart,
    37  the '--debug' and '--dry-run' flags can be combined. This will still require a
    38  round-trip to the Tiller server.
    39  
    40  If --verify is set, the chart MUST have a provenance file, and the provenenace
    41  fall MUST pass all verification steps.
    42  
    43  There are four different ways you can express the chart you want to install:
    44  
    45  1. By chart reference: helm install stable/mariadb
    46  2. By path to a packaged chart: helm install ./nginx-1.2.3.tgz
    47  3. By path to an unpacked chart directory: helm install ./nginx
    48  4. By absolute URL: helm install https://example.com/charts/nginx-1.2.3.tgz
    49  
    50  CHART REFERENCES
    51  
    52  A chart reference is a convenient way of reference a chart in a chart repository.
    53  
    54  When you use a chart reference ('stable/mariadb'), Helm will look in the local
    55  configuration for a chart repository named 'stable', and will then look for a
    56  chart in that repository whose name is 'mariadb'. It will install the latest
    57  version of that chart unless you also supply a version number with the
    58  '--version' flag.
    59  
    60  To see the list of chart repositories, use 'helm repo list'. To search for
    61  charts in a repository, use 'helm search'.
    62  
    63  
    64  ```
    65  helm install [CHART]
    66  ```
    67  
    68  ### Options
    69  
    70  ```
    71        --dry-run                simulate an install
    72        --keyring string         location of public keys used for verification (default "~/.gnupg/pubring.gpg")
    73    -n, --name string            release name. If unspecified, it will autogenerate one for you
    74        --name-template string   specify template used to name the release
    75        --namespace string       namespace to install the release into
    76        --no-hooks               prevent hooks from running during install
    77        --replace                re-use the given name, even if that name is already used. This is unsafe in production
    78        --set stringArray        set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
    79        --timeout int            time in seconds to wait for any individual kubernetes operation (like Jobs for hooks) (default 300)
    80    -f, --values valueFiles      specify values in a YAML file (can specify multiple) (default [])
    81        --verify                 verify the package before installing it
    82        --version string         specify the exact chart version to install. If this is not specified, the latest version is installed
    83  ```
    84  
    85  ### Options inherited from parent commands
    86  
    87  ```
    88        --debug                     enable verbose output
    89        --home string               location of your Helm config. Overrides $HELM_HOME (default "~/.helm")
    90        --host string               address of tiller. Overrides $HELM_HOST
    91        --kube-context string       name of the kubeconfig context to use
    92        --tiller-namespace string   namespace of tiller (default "kube-system")
    93  ```
    94  
    95  ### SEE ALSO
    96  * [helm](helm.md)	 - The Helm package manager for Kubernetes.
    97  
    98  ###### Auto generated by spf13/cobra on 15-Jan-2017