github.com/zoumo/helm@v2.5.0+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        --annotations stringArray   set release annotations (can specify multiple or separate values with commas: key1=val1,key2=val2)
    72        --ca-file string            verify certificates of HTTPS-enabled servers using this CA bundle
    73        --cert-file string          identify HTTPS client using this SSL certificate file
    74        --devel                     use development versions, too. Equivalent to version '>0.0.0-a'. If --version is set, this is ignored.
    75        --dry-run                   simulate an install
    76        --key-file string           identify HTTPS client using this SSL key file
    77        --keyring string            location of public keys used for verification (default "~/.gnupg/pubring.gpg")
    78    -n, --name string               release name. If unspecified, it will autogenerate one for you
    79        --name-template string      specify template used to name the release
    80        --namespace string          namespace to install the release into
    81        --no-hooks                  prevent hooks from running during install
    82        --replace                   re-use the given name, even if that name is already used. This is unsafe in production
    83        --repo string               chart repository url where to locate the requested chart
    84        --set stringArray           set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
    85        --timeout int               time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
    86        --tls                       enable TLS for request
    87        --tls-ca-cert string        path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
    88        --tls-cert string           path to TLS certificate file (default "$HELM_HOME/cert.pem")
    89        --tls-key string            path to TLS key file (default "$HELM_HOME/key.pem")
    90        --tls-verify                enable TLS for request and verify remote
    91    -f, --values valueFiles         specify values in a YAML file (can specify multiple) (default [])
    92        --verify                    verify the package before installing it
    93        --version string            specify the exact chart version to install. If this is not specified, the latest version is installed
    94        --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
    95  ```
    96  
    97  ### Options inherited from parent commands
    98  
    99  ```
   100        --debug                     enable verbose output
   101        --home string               location of your Helm config. Overrides $HELM_HOME (default "$HOME/.helm")
   102        --host string               address of Tiller. Overrides $HELM_HOST
   103        --kube-context string       name of the kubeconfig context to use
   104        --tiller-namespace string   namespace of Tiller (default "kube-system")
   105  ```
   106  
   107  ### SEE ALSO
   108  * [helm](helm.md)	 - The Helm package manager for Kubernetes.
   109  
   110  ###### Auto generated by spf13/cobra on 12-Jul-2017