Helm - v3.8.0

v3.8.0

Helm v3.8.0 is a feature release. This release, we focused on OCI registries, support for Kubernetes 1.23, and more. Users are encouraged to upgrade for the best experience.

The community keeps growing, and we'd love to see you there!

• Join the discussion in Kubernetes Slack:
• for questions and just to hang out
• for discussing PRs, code, and bugs
• Hang out at the Public Developer Call: Thursday, 9:30 Pacific via Zoom
• Test, debug, and contribute charts: ArtifactHub/packages

Notable Changes

• OCI registry support for charts is now generally available. It has graduated out of being an experiment. Some changes over Helm 3.7 include:
• When setting a chart in the dependencies as OCI the version can be set to a range, like other dependencies
• SemVer tags that include build information can be pushed and used. OCI registries don't support + as a tag character. Helm translates the + to _ when stored as a tag
• helm registry login now follows the same structure as the Docker CLI for storing credentials. The same location for registry configuration can be passed to both Helm and the Docker CLI
• A --list-repo-url flag has been added to helm search hub to quickly show the repositories URL.
• Release names are validated during installation
• Added support for installing Helm on Windows via Cygwin
• Added support for Kubernetes 1.23

Installation and Upgrading

Download Helm v3.8.0. The common platform binaries are here:

• MacOS amd64 (checksum / 532ddd6213891084873e5c2dcafa577f425ca662a6594a3389e288fc48dc2089)
• MacOS arm64 (checksum / 751348f1a4a876ffe089fd68df6aea310fd05fe3b163ab76aa62632e327122f3)
• Linux amd64 (checksum / 8408c91e846c5b9ba15eb6b1a5a79fc22dd4d33ac6ea63388e5698d1b2320c8b)
• Linux arm (checksum / 05e900d0688edd8d455e0d4c51b419cd2b10120d485be7a1262582f51c92e941)
• Linux arm64 (checksum / 23e08035dc0106fe4e0bd85800fd795b2b9ecd9f32187aa16c49b0a917105161)
• Linux i386 (checksum / ed845e2e2631eddf526cab606f023fded03c5b99175f7cacd5edcd41800c7e45)
• Linux ppc64le (checksum / 5070fa5188e7bc798dd54bc1ea9fc4cda623d9ff45eedb05ec93db234309f391)
• Linux s390x (checksum / f8088ea57290fcc0aae50e2075c1adc258247cdf55169e9a9ca7762a64f558db)
• Windows amd64 (checksum / d52e0cda6c4cc0e0717d5161ca1ba7a8d446437afdbe42b3c565c145ac752888)

This release was signed with 672C 657B E06B 4B30 969C 4A57 4614 49C2 5E36 B98E and can be found at @mattfarina keybase account. Please use the attached signatures for verifying this release using gpg.

The Quickstart Guide will get you going from there. For upgrade instructions or detailed installation notes, check the install guide. You can also use a script to install on any system with bash.

What's Next

• 3.8.1 will contain only bug fixes and be released on March 09, 2022.
• 3.9.0 is the next feature release and will be released on May 11, 2022.

Changelog

• Limits need to call tag API when explicit version specified d14138609b01886f544b2025f5000351c9eb092e (Andrew Block)
• bump version to v3.8.0 d493f29c323799df1fc9aa3e3aa9d4e68ac6b55d (Matt Farina)
• Moving uploader and pusher out of action into pkg 9661e39dce46785089fb93a647f95c7526ec28c8 (David Peraza)
• Move all the remainder module out of experimental. 7cab1a09e30edc3892edab5fd3a73811dbf1ec76 (David Peraza)
• Removing all the checks for oci experimental flag 9f869c6b214e75b48024fc9e1b2fb1c51e76b63d (David Peraza)
• move paths for updated directory location 91a46ad14f5d3a2248f005b722fb37dc23e9e8f3 (Thomas Runyon)
• refactor internal/experimental/registry to pkg/registry 353d74e96725fab3b7c4d1f8af37998a137009e9 (Thomas Runyon)
• Fix panic with OCI for install, upgrade, and show 548ec55cf9ee54f8563c2848b9f9fd33b8753936 (Matt Farina)
• Change underscore (_) back to plus (+) for Helm 808a2d1908088137a16d086dd86802ece7bd13b3 (Scott Rigby)
• Remove unneeded assignment ee382eb169bab70a3b44571ce5c363b80f1399e1 (Scott Rigby)
• Bring exact version check logic from IndexFile.Get into registry tag check bd754a054c73a6c6dc4d342cda0a0ecdd4ce96d0 (Scott Rigby)
• Handling name of OCI file 1a9cb93551dd112ab91c0dd0982819979787e637 (Andrew Block)
• Updates to chart downloader 23989f9e2411aa603066356076f43840bcd2d212 (Andrew Block)
• Fix linting ba4020770ec21286dbf9cb4b6c6c82b42ee8d4d3 (Scott Rigby)
• Move OCI tag semver range logic from OCIGetter to ChartDownloader 4d50526a2bcf788d2518cb42dd468863bd3f0332 (Scott Rigby)
• Fixing issue where OCI handling early causes a bad message c7b2a9d48795e1191b80a1f94acca5b4f084d612 (Matt Farina)
• Update oras-go to v1.1.0 1b3e0bc46a3e22cfa8f0adce08a18c8436152b30 (Scott Rigby)
• Fixed bad commit 9c3b0008896d840237617bae8cc9823b77b536d4 (Andrew Block)
• Readded resolver OCI logic 828941b273e1c6393bec6723ae2cc394c0536db4 (Andrew Block)
• Enabled auth and support http registries for OCI 291c17fcc5627c85a0c378e0ba83eb0c5ae6dffc (Andrew Block)
• Fix import 4c8a3faaa28e67316297d68fcb1cca0a54a8ae56 (Scott Rigby)
• Implement reusable GetTagMatchingVersionOrConstraint b6bf3905f37b13863efc5c5309bb154853ac6daa (Scott Rigby)
• Started work on 'helm pull' 4f62d3dc1b8b95246eb345f8e9117adee6d52f91 (Andrew Block)
• Working oci code without providing versions df98e18eb73cd08feee1c9e7ddf0e629ad510ee7 (Andrew Block)
• Updated tag resolver logic 0fae7f5008b4dc64dc5f830b819094c78a313d06 (Andrew Block)
• Added registryClient to resolver 834a11db567b1e154ed976c03a7556c336ad4c7b (Andrew Block)
• Fix Trim to TrimPrefix 1fabbabae9fd0c76fccf2a6658de867d8cf96ab9 (Scott Rigby)
• Update ORAS to v1.1.0-rc1 a8df413c4116fde82c00ba72563ff5ff5d1b8300 (Scott Rigby)
• Add OCI tag verions to the Dependency object before Resolve. TODO: fix HTTP HTTPS error for local registries e3f2fb42357fbe67257b0eeacd82cb6cba98c7c1 (Scott Rigby)
• Initial tag listing support 9a7c362dd115431f9f5c17606113769ec036530c (Andrew Block)
• Revert "It appears we never got to this block below. Quick rec by Farina. Untested if necessary" 39792b5ad004a99b3ef649a649a0f1834b07a0f6 (Scott Rigby)
• Revert "hack in progress" 3dc9930488aeaf2fb6a15c266255ae9691167f8f (Scott Rigby)
• It appears we never got to this block below. Quick rec by Farina. Untested if necessary 16453c372c41a82e676ba95a18b88890060f16b0 (Scott Rigby)
• Temp use Andy's fork PR branch 042e13d0d10dda30eadbc7f9069417a33bffd919 (Scott Rigby)
• hack in progress 0d2f0116eac616d9b3a3b8836a8d854bbe40be74 (Scott Rigby)
• registry/client: use NewClientWithDockerFallback from oras v1.1.0-rc3 e3897ad6b10ba2bf02b7505fb2baa63e74039b6f (Allen Bai)
• HELM_REGISTRY_CONFIG: change default file of registry config to config.json e08a9270be1b3be83397c73e7635fd2ecd8f043d (Allen Bai)
• ensure consistency in registry client Push/Pull function signatures. ensure message is only printed when tags contain a replaced character fed0d31bf5ea07515acb8f766a9a205fb8c84d46 (Josh Wolf)
• Fix typo. Thanks buildbot. Also comments at 80 chars 157ac85ab72827062b963a99ab7990c31804c5dd (Scott Rigby)
• add oci reference validation and tag scoped (+) replacement to registry client Push/Pull fb0eeebf66f290079acb2e957ba5bde93dc33b9f (Josh Wolf)
• add more debug msg when helm upgrade f82896b0b5bf0199120e372c0778314b8ab7a7fd (yxxhero)
• Fixing issue where OCI handling early causes a bad message ee73a0263c02a6c53261fdaf2ad97542b18a844c (Matt Farina)
• Update registry underscore message with semver note for extra clarity 8424bc2b607118243ea1be4f3371c3947833e3b5 (Scott Rigby)
• Move plus/underscore change to inside Client. Compare original ref for strict mode 4aacbc44e0357a30ff644b2030f39f728c87ce41 (Scott Rigby)
• Adding Joe Julian as triage maintainer a30a8481b8d83e64574bb5ba2c1b632046654d63 (Bridget Kromhout)
• For OCI, convert + to _ before pull, and + to _ before push 472eb6f096eda77da8340fac88acab5ba6452ac5 (Scott Rigby)
• feat(comp): Allow fuzzy matching during completion b8d3535991dd5089d58bc88c46a5ffe2721ae830 (Marc Khouzam)
• validate release name during install 160da867d05ed3a0585e8bc4bf55f9fdeefe0d9f (mengjiao.liu)
• lean up extra spaces 55bb6c307ab041133bbcd6a6a95aa760a2e85433 (jayonlau)
• chore(deps): bump github.com/docker/docker babbb67f89d859eb88e6dfeb76877423e933ee98 (dependabot[bot])
• chore(deps): bump github.com/spf13/cobra from 1.2.1 to 1.3.0 d417878a694f033f5855cfd6ae86651177bb0993 (dependabot[bot])
• Updating Kubernetes packages to those from 1.23.1 5c698e9fa7d93ce9b733e0b1f5b2d70983149fae (Matt Farina)
• Moving prydonius to emeritus ad1110eabaa774e670c27cb354c4fea58c8c0e44 (Bridget Kromhout)
• Channel should remain open if there is still a routine that wants to write into it 9a492f8240d177d97d59c87d168059fa6181f96e (Jerome Küttner)
• Fix memory leak in upgrade action ad3d2cc8efc12e2aa7a0144ed4a11169193646e3 (Jerome Küttner)
• Bringing over an edit from the helm-www repo 21e1cd60271919f03a2b5cc65af3c7c49aca223f (Bridget Kromhout)
• docs: Clarify use of --set-file 13d86143f8f1b8aac1e0df9410c3699868109af6 (David Xia)
• chore(deps): bump github.com/Masterminds/squirrel from 1.5.1 to 1.5.2 a840fb09405bc7a279b048dc2b00d02bf8c07a9d (dependabot[bot])
• chore(deps): bump github.com/mattn/go-shellwords from 1.0.11 to 1.0.12 664d5e63e3a5a5ca987b54f1297e710e27138eb6 (dependabot[bot])
• fix(pkg/kube): statefulSetReady: handle partition cases correctly c3310bb72496e97237008f5f9fafa52f5d7d69a9 (Bhavin Gandhi)
• Update HELM_PLUGIN_SELF -> HELM_PLUGIN_DIR (#10380) 4bf99e54ebf943f79e990093a09b97bbface6405 (Tyler Auerbeck)
• Add support for installing on Windows via Cygwin 799339316f0cb19e0e8489b0045d33bc24cd8f96 (Ioan Indreias)
• Updating to Kubernetes 1.22.4 packages c2da47e22bde420602b46d9e6b6e3152c63f7a90 (Matt Farina)
• chore(deps): bump github.com/Masterminds/squirrel from 1.5.0 to 1.5.1 6a1daecd0c29bad92e4c5429ccf88b5f3cd3dd6f (dependabot[bot])
• chore(deps): Bump github.com/mitchellh/copystructure from 1.1.1 to 1.2.0 6d96e5e4d6315077ea36651c3a8daa7ff1c8a46d (dependabot[bot])
• Upgrade to oras-go v1.0.0 b66c468812e09e384fb128bf9e8863a58c3ec0f1 (Josh Dolitsky)
• OWNERS: add zonggen to triage maintainers list 08eb75b3cd45aa6da3bc05978b05e08f57f63228 (Allen Bai)
• Fix specifying of Kubernetes version from build scripts 7838fb769d00f53c858d994a873f42c2960a7d25 (Matt Farina)
• chore(deps): bump github.com/gofrs/flock from 0.8.0 to 0.8.1 46a643fff49c71a5e2da60b61a3f7d305c06e6ef (dependabot[bot])
• chore(deps): bump github.com/docker/docker 7293ac238814eae6117427a42f763a2e4d257348 (dependabot[bot])
• chore(deps): bump github.com/lib/pq from 1.10.3 to 1.10.4 fdb97665e4d3e9bdb81c226e5f7cbc640d370c26 (dependabot[bot])
• Add nolint comments 889c70b7293192aea2637178cf3a1a4c688b2692 (Josh Dolitsky)
• update CI to use Go 1.17 3841af9a963b1070267ed4880f064ec8b5f624f7 (Josh Dolitsky)
• Use buffered channel for signal notification ea1b1f5a0751cfb65940d2c16d2d71c0fe655b8f (Martin Hickey)
• chore(deps): bump sigs.k8s.io/yaml from 1.2.0 to 1.3.0 15a9e141fd14a437f0461f526635b148a62132fd (dependabot[bot])
• chore(deps): bump k8s.io/klog/v2 from 2.9.0 to 2.30.0 90b78aead640f2ec8b7148078598dc683fe5abff (dependabot[bot])
• fix: added resource info into the validation error 7f68bfa1fa9146b0fcc0cb6b30a50f6df40cc7ff (Timofey Kirillov)
• Updating to Kubernetes 1.22.3 packages fcc5dd7f3b46446c88230074b14df9141ffbe1ac (David Peraza)
• Add yxxhero as triage maintainer b6a04cfbd544f0bbeea449129c1497eec8d99e2b (Marc Khouzam)
• allow ldflags to overwrite k8s version 81a373ead5e1d99cbe6febaf35716fe2e206c0c7 (Sverre Boschman)
• ensure error is correctly handled when generating chart's oci manifest fae500938261f123fa091dac1acd2da1356ecd07 (Josh Wolf)
• modify oci chart push/pull manifest test values to represent new order sorted by oras d2d8e5240178e54fd402c383c899f5c0c56692cc (Josh Wolf)
• fix a SIGSEGV similar to issue 1347 fe6f348490f32d5dab3173e037626b8f12cd431c (Brandon Cole)
• Adding Scott Rigby as helm/helm maintainer 5782c39c372f9c524053aa47df29d5832826cadf (Bridget Kromhout)
• Fail if target-directory does not exist e3e563a31825ce78e13ef11f19fc66c41782345b (Dominik Stadler)
• Fix a golint issue caused by typo 9b7a45a384dff68c96e0811e267cebfbe6b6ac2f (Guangwen Feng)
• upgrade oras to 0.5.0, refactor client oci logic to use new oras.Copy() 7cec93d9fb724f261d7902f6e5428c84cda77b01 (Josh Wolf)
• Updated oci format logic ea49d811bff09697fff736a8a52165691d5862d5 (Asir Tamboli)
• fix(helm): process dependencies import-values 1931b0702dd7f0d19a66ddd9b882d62e7622943d (Stuart Drennan)
• Add missing pipe to wget variant f0f55faac8efddb10003e23ebf66408f1b5c7cae (Dan Russell)
• Update installer to reflect new GitHub HTML 2cf7e1fec4d0d9c625b487a3d607170572fc7c0c (Dan Russell)
• Bump github.com/BurntSushi/toml from 0.3.1 to 0.4.1 24303955f8e07814f915f3388ed8efb5ebce1b6b (dependabot[bot])
• chore(deps): bump github.com/cyphar/filepath-securejoin 5b2805b5f62a874f982ac4dc2b6b6b013d8f0852 (dependabot[bot])
• add unittest for SetNamespace method 0d3289eb0b2db911d1b08d54833b4ddf127f6d25 (yxxhero)
• add SetNamespace method for EnvSettings, in order to set namespace in helm sdk d376a67ba86c719431310f7797530bb7b020ea81 (yxxhero)
• docs: fix typo Charts.yaml 5753f61ae35c2507b3116d84662d45f51cfa2099 (Alexey Igrychev)
• actually skip unverifiable files 6f0064d61b823a85088cf68a4740eea0c0e31468 (Fabian Jucker)
• Bump github.com/containerd/containerd from 1.5.4 to 1.5.7 f9bd8e93f29ef28faa96a6be8a0ad01b460ae496 (dependabot[bot])
• Fix default registry config path of oci protocol provider 52cbc2f49c0f2e1675783f04b1426166419da46c (Kai Takac)
• changes to support any mediatype for layers on download 9e29f1619b051345683dc5ad12435bca8b186c16 (LochanRn)
• chore(deps): Bump github.com/jmoiron/sqlx from 1.3.1 to 1.3.4 552499d395c878b7e03cf43a148a424fb96141e8 (dependabot[bot])
• Make validation errors easier to fix 9fa373e8be0a6f4f3d25be91a6c7be874f7714ac (Damien Nozay)
• fix tarFromLocalDir saving file dependencies in dest path d2dd32470b312095e8c7399146bc684b89ffeaa6 (Matthew Fisher)
• Bump github.com/lib/pq from 1.10.0 to 1.10.3 e4e740e3143f20da0c86e837732ecd14c9c1ab5f (dependabot[bot])
• fix(install): if subcharts are disabled, the CRD for subcharts should not be installed da15d96a680111a09f0436b19afb07fd9895fa02 (cndoit18)
• Fixing issue with non-existant .Template when using tpl function f895948ae21e30ef9392201ca4d5f55525cafb62 (Matt Farina)
• bump version to 3.7 e6a92c4b627ec7df8b6b309ae08441cd64f1a4be (Matt Farina)
• Replace cli flag --list-repo with --list-repo-url 144048d5fa95ad9e7cef5af2e735b01802e613b2 (Dmitrii Ermakov)
• Reintroduce --list-repo flag in search repo 5b101ec504f1c1190dd15134c74881a59a87f829 (Dmitrii Ermakov)
• Reintroduce --list-repo flag in search repo 2dd88e846fd0d848b00b2e393916328f8eaeacd2 (Dmitrii Ermakov)
• Add hint to missing dependency message 5421280a2b19836be1b3a24190cc099e2ae64348 (Johannes Hertenstein)
• Add error check to avoid panic 8959d93711b94bba9c6f94aabe3e77d0eb504220 (Cookie Wang)
• Removed list-repo flag. 3d0bb987cb29fcbef5dc8d1ca38097e943a2a039 (Dmitriy Ermakov)
• Added flag --list-repo 1b251fbe0bb69e78e700d2d0d350b0eb13459aef (Dmitriy Ermakov)