helm upgrade

helm upgrade

릴리스를 업그레이드하는 명령입니다.

출처: 문서

본문

이 명령은 릴리스를 차트의 새 버전으로 업그레이드합니다.

업그레이드 인자는 릴리스와 차트여야 합니다. 차트 인자는 차트 참조('example/mariadb'), 차트 디렉터리 경로, 패키징된 차트, 또는 완전한 URL 중 하나일 수 있습니다. 차트 참조의 경우 --version 플래그가 설정되지 않으면 최신 버전이 지정됩니다.

차트의 값을 재정의하려면 --values 플래그를 사용해 파일을 전달하거나 --set 플래그를 사용해 명령줄에서 구성을 전달합니다. 문자열 값을 강제하려면 --set-string 을 사용하세요. 값 자체가 명령줄에 넣기 너무 길거나 동적으로 생성되는 경우 --set-file 로 파일에서 개별 값을 설정할 수 있습니다. 또한 --set-json 으로 명령줄에서 JSON 값(스칼라/객체/배열)을 설정할 수도 있고, JSON 객체를 문자열로 전달할 수도 있습니다.

--values/-f 플래그를 여러 번 지정할 수 있습니다. 마지막(가장 오른쪽)에 지정한 파일에 우선순위가 주어집니다. 예를 들어 myvalues.yaml 과 override.yaml 둘 다 Test 라는 키를 포함한다면 override.yaml 의 값이 우선합니다.

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

--set 플래그도 여러 번 지정할 수 있습니다. 마지막(가장 오른쪽)에 지정한 set 에 우선순위가 주어집니다. 예를 들어 foo 라는 키에 'bar' 와 'newbar' 두 값이 설정되면 'newbar' 값이 우선합니다.

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

--reuse-values 플래그를 통해 이 명령으로 기존 릴리스의 값을 업데이트할 수도 있습니다. RELEASECHART 인자는 원래 매개변수로 설정해야 하며, 기존 값은 --values/-f 또는 --set 플래그로 설정된 값과 병합됩니다. 새 값에 우선순위가 주어집니다.

    $ helm upgrade --reuse-values --set foo=bar --set foo=newbar redis ./redis

--dry-run 플래그는 민감한 값을 포함할 수 있는 Secrets 를 포함해 생성된 모든 차트 매니페스트를 출력합니다. Kubernetes Secrets 를 숨기려면 --hide-secret 플래그를 사용하세요. 이 플래그들을 어떻게, 언제 사용할지 신중히 고려하세요.

시놉시스 (Synopsis)

helm upgrade [RELEASE] [CHART] [flags]

옵션 (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
      --cleanup-on-fail                            allow deletion of new resources created in this upgrade when upgrade fails
      --create-namespace                           if --install is set, create the release namespace if not present
      --dependency-update                          update dependencies if they are missing before installing the chart
      --description string                         add a custom description
      --devel                                      use development versions, too. Equivalent to version '>0.0.0-0'. If --version is set, this is ignored
      --disable-openapi-validation                 if set, the upgrade process will not validate rendered templates against the Kubernetes OpenAPI Schema
      --dry-run string[="unset"]                   simulates the operation without persisting changes. Must be one of: "none" (default), "client", or "server". '--dry-run=none' executes the operation normally and persists changes (no simulation). '--dry-run=client' simulates the operation client-side only and avoids cluster connections. '--dry-run=server' simulates the operation on the server, requiring cluster connectivity. (default "none")
      --enable-dns                                 enable DNS lookups when rendering templates
      --force-conflicts                            if set server-side apply will force changes against conflicts
      --force-replace                              force resource updates by replacement
  -h, --help                                       help for upgrade
      --hide-notes                                 if set, do not show notes in upgrade output. Does not affect presence in chart metadata
      --hide-secret                                hide Kubernetes Secrets when also using the --dry-run flag
      --history-max int                            limit the maximum number of revisions saved per release. Use 0 for no limit (default 10)
      --insecure-skip-tls-verify                   skip tls certificate checks for the chart download
  -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                             location of public keys used for verification (default "~/.gnupg/pubring.gpg")
  -l, --labels stringToString                      Labels that would be added to release metadata. Should be separated by comma. Original release labels will be merged with upgrade labels. You can unset label using null. (default [])
      --no-hooks                                   disable pre/post upgrade hooks
  -o, --output format                              prints the output in the specified format. Allowed values: table, json, yaml (default table)
      --pass-credentials                           pass credentials to all domains
      --password string                            chart repository password where to locate the requested chart
      --plain-http                                 use insecure HTTP connections for the chart download
      --post-renderer postRendererString           the name of a postrenderer type plugin to be used for post rendering. If it exists, the plugin will be used
      --post-renderer-args postRendererArgsSlice   an argument to the post-renderer (can specify multiple) (default [])
      --render-subchart-notes                      if set, render subchart notes along with the parent
      --repo string                                chart repository url where to locate the requested chart
      --reset-then-reuse-values                    when upgrading, reset the values to the ones built into the chart, apply the last release's values and merge in any overrides from the command line via --set and -f. If '--reset-values' or '--reuse-values' is specified, this is ignored
      --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 overrides from the command line via --set and -f. If '--reset-values' is specified, this is ignored
      --rollback-on-failure                        if set, Helm will rollback the upgrade to previous success release upon failure. The --wait flag will be defaulted to "watcher" if --rollback-on-failure is set
      --server-side string                         must be "true", "false" or "auto". Object updates run in the server instead of the client ("auto" defaults the value from the previous chart release's method) (default "auto")
      --set stringArray                            set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
      --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)
      --set-json stringArray                       set JSON values on the command line (can specify multiple or separate values with commas: key1=jsonval1,key2=jsonval2 or using json format: {"key1": jsonval1, "key2": "jsonval2"})
      --set-literal stringArray                    set a literal STRING value on the command line
      --set-string stringArray                     set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
      --skip-crds                                  if set, no CRDs will be installed when an upgrade is performed with install flag enabled. By default, CRDs are installed if not already present, when an upgrade is performed with install flag enabled
      --skip-schema-validation                     if set, disables JSON schema validation
      --take-ownership                             if set, upgrade will ignore the check for helm annotations and take ownership of the existing resources
      --timeout duration                           time to wait for any individual Kubernetes operation (like Jobs for hooks) (default 5m0s)
      --username string                            chart repository username where to locate the requested chart
  -f, --values strings                             specify values in a YAML file or a URL (can specify multiple)
      --verify                                     verify the package before using it
      --version string                             specify a version constraint for the chart version to use. This constraint can be a specific tag (e.g. 1.1.1) or it may reference a valid range (e.g. ^2.0.0). If this is not specified, the latest version is used
      --wait WaitStrategy[=watcher]                wait until resources are ready (up to --timeout). Use '--wait' alone for 'watcher' strategy, or specify one of: 'watcher', 'hookOnly', 'legacy'. Default when flag is omitted: 'hookOnly'. (default hookOnly)
      --wait-for-jobs                              if set and --wait enabled, will wait until all Jobs have been completed before marking the release as successful. It will wait for as long as --timeout

부모 명령에서 상속받은 옵션 (Options inherited from parent commands)

      --burst-limit int                 client-side default throttling limit (default 100)
      --color string                    use colored output (never, auto, always) (default "auto")
      --colour string                   use colored output (never, auto, always) (default "auto")
      --content-cache string            path to the directory containing cached content (e.g. charts) (default "~/.cache/helm/content")
      --debug                           enable verbose output
      --kube-apiserver string           the address and the port for the Kubernetes API server
      --kube-as-group stringArray       group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --kube-as-user string             username to impersonate for the operation
      --kube-ca-file string             the certificate authority file for the Kubernetes API server connection
      --kube-context string             name of the kubeconfig context to use
      --kube-insecure-skip-tls-verify   if true, the Kubernetes API server's certificate will not be checked for validity. This will make your HTTPS connections insecure
      --kube-tls-server-name string     server name to use for Kubernetes API server certificate validation. If it is not provided, the hostname used to contact the server is used
      --kube-token string               bearer token used for authentication
      --kubeconfig string               path to the kubeconfig file
  -n, --namespace string                namespace scope for this request
      --qps float32                     queries per second used when communicating with the Kubernetes API, not including bursting
      --registry-config string          path to the registry config file (default "~/.config/helm/registry/config.json")
      --repository-cache string         path to the directory containing cached repository indexes (default "~/.cache/helm/repository")
      --repository-config string        path to the file containing repository names and URLs (default "~/.config/helm/repositories.yaml")

함께 보기 (SEE ALSO)

  • helm - Kubernetes용 Helm 패키지 매니저.

더 알아보기 (Learn more)

  • helm - Helm CLI의 최상위 명령