github.com/Beeketing/helm@v2.12.1+incompatible/docs/helm/helm_upgrade.md (about)

     1  ## helm upgrade
     2  
     3  upgrade a release
     4  
     5  ### Synopsis
     6  
     7  
     8  This command upgrades a release to a specified version of a chart and/or updates chart values.
     9  
    10  Required arguments are release and chart. The chart argument can be one of:
    11   - a chart reference('stable/mariadb'); use '--version' and '--devel' flags for versions other than latest,
    12   - a path to a chart directory,
    13   - a packaged chart,
    14   - a fully qualified URL.
    15  
    16  To customize the chart values, use any of
    17   - '--values'/'-f' to pass in a yaml file holding settings,
    18   - '--set' to provide one or more key=val pairs directly,
    19   - '--set-string' to provide key=val forcing val to be stored as a string,
    20   - '--set-file' to provide key=path to read a single large value from a file at path.
    21  
    22  To edit or append to the existing customized values, add the 
    23   '--reuse-values' flag, otherwise any existing customized values are ignored.
    24  
    25  If no chart value arguments are provided on the command line, any existing customized values are carried
    26  forward. If you want to revert to just the values provided in the chart, use the '--reset-values' flag.
    27  
    28  You can specify any of the chart value flags multiple times. The priority will be given to the last
    29  (right-most) value specified. For example, if both myvalues.yaml and override.yaml contained a key
    30  called 'Test', the value set in override.yaml would take precedence:
    31  
    32  	$ helm upgrade -f myvalues.yaml -f override.yaml redis ./redis
    33  
    34  Note that the key name provided to the '--set', '--set-string' and '--set-file' flags can reference
    35  structure elements. Examples:
    36    - mybool=TRUE
    37    - livenessProbe.timeoutSeconds=10
    38    - metrics.annotations[0]=hey,metrics.annotations[1]=ho
    39  
    40  which sets the top level key mybool to true, the nested timeoutSeconds to 10, and two array values, respectively.
    41  
    42  Note that the value side of the key=val provided to '--set' and '--set-string' flags will pass through
    43  shell evaluation followed by yaml type parsing to produce the final value. This may alter inputs with
    44  special characters in unexpected ways, for example
    45  
    46  	$ helm upgrade --set pwd=3jk$o2,z=f\30.e redis ./redis
    47  
    48  results in "pwd: 3jk" and "z: f30.e". Use single quotes to avoid shell evaluation and argument delimiters,
    49  and use backslash to escape yaml special characters:
    50  
    51  	$ helm upgrade --set pwd='3jk$o2z=f\\30.e' redis ./redis
    52  
    53  which results in the expected "pwd: 3jk$o2z=f\30.e". If a single quote occurs in your value then follow
    54  your shell convention for escaping it; for example in bash:
    55  
    56  	$ helm upgrade --set pwd='3jk$o2z=f\\30with'\''quote'
    57  
    58  which results in "pwd: 3jk$o2z=f\30with'quote".
    59  
    60  
    61  ```
    62  helm upgrade [RELEASE] [CHART] [flags]
    63  ```
    64  
    65  ### Options
    66  
    67  ```
    68        --ca-file string           verify certificates of HTTPS-enabled servers using this CA bundle
    69        --cert-file string         identify HTTPS client using this SSL certificate file
    70        --description string       specify the description to use for the upgrade, rather than the default
    71        --devel                    use development versions, too. Equivalent to version '>0.0.0-0'. If --version is set, this is ignored.
    72        --dry-run                  simulate an upgrade
    73        --force                    force resource update through delete/recreate if needed
    74    -h, --help                     help for upgrade
    75    -i, --install                  if a release by this name doesn't already exist, run an install
    76        --key-file string          identify HTTPS client using this SSL key file
    77        --keyring string           path to the keyring that contains public signing keys (default "~/.gnupg/pubring.gpg")
    78        --namespace string         namespace to install the release into (only used if --install is set). Defaults to the current kube config namespace
    79        --no-hooks                 disable pre/post upgrade hooks
    80        --password string          chart repository password where to locate the requested chart
    81        --recreate-pods            performs pods restart for the resource if applicable
    82        --repo string              chart repository url where to locate the requested chart
    83        --reset-values             when upgrading, reset the values to the ones built into the chart
    84        --reuse-values             when upgrading, reuse the last release's values and merge in any overrides from the command line via --set and -f. If '--reset-values' is specified, this is ignored.
    85        --set stringArray          set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
    86        --set-file stringArray     set values from respective files specified via the command line (can specify multiple or separate values with commas: key1=path1,key2=path2)
    87        --set-string stringArray   set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
    88        --timeout int              time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks) (default 300)
    89        --tls                      enable TLS for request
    90        --tls-ca-cert string       path to TLS CA certificate file (default "$HELM_HOME/ca.pem")
    91        --tls-cert string          path to TLS certificate file (default "$HELM_HOME/cert.pem")
    92        --tls-hostname string      the server name used to verify the hostname on the returned certificates from the server
    93        --tls-key string           path to TLS key file (default "$HELM_HOME/key.pem")
    94        --tls-verify               enable TLS for request and verify remote
    95        --username string          chart repository username where to locate the requested chart
    96    -f, --values valueFiles        specify values in a YAML file or a URL(can specify multiple) (default [])
    97        --verify                   verify the provenance of the chart before upgrading
    98        --version string           specify the exact chart version to use. If this is not specified, the latest version is used
    99        --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
   100  ```
   101  
   102  ### Options inherited from parent commands
   103  
   104  ```
   105        --debug                           enable verbose output
   106        --home string                     location of your Helm config. Overrides $HELM_HOME (default "~/.helm")
   107        --host string                     address of Tiller. Overrides $HELM_HOST
   108        --kube-context string             name of the kubeconfig context to use
   109        --kubeconfig string               absolute path to the kubeconfig file to use
   110        --tiller-connection-timeout int   the duration (in seconds) Helm will wait to establish a connection to tiller (default 300)
   111        --tiller-namespace string         namespace of Tiller (default "kube-system")
   112  ```
   113  
   114  ### SEE ALSO
   115  
   116  * [helm](helm.md)	 - The Helm package manager for Kubernetes.
   117  
   118  ###### Auto generated by spf13/cobra on 24-Aug-2018