3.8.2

Latest release in branch 3.8
Released 13 Apr 2022 (4 years ago)

SoftwareHelm
Branch3.8
Status
End of life
Initial release3.8.0
24 Jan 2022 (4 years ago)
Latest patch release3.8.2
13 Apr 2022 (4 years ago)
Supported
Kubernetes versions
1.23.x - 1.20.x
Active support end18 May 2022 (Ended 3 years, 11 months ago)
Release noteshttps://github.com/helm/helm/releases/tag/v3.8.2
Source codehttps://github.com/helm/helm/tree/v3.8.2
Downloadhttps://github.com/helm/helm/releases/tag/v3.8.2
Helm 3.8 ReleasesView full list

What Is New in Helm 3.8

Category Highlights
New Features
  • OCI registry support graduated to GA
  • Version ranges for OCI dependencies
  • SemVer tags with build metadata (+ translated to _)
  • helm registry login now mirrors Docker CLI behavior
  • --list-repo-url flag for helm search hub
  • Release name validation on install
  • Windows Cygwin installation support
  • Kubernetes 1.23 compatibility
Improvements
  • Better error handling for OCI pull/push
  • Consistent registry configuration location
  • Enhanced chart downloader logic
Bug Fixes
  • Fixed panic scenarios in OCI install/upgrade/show
  • Resolved memory leak in upgrade action
  • Corrected release‑name validation edge cases
  • Fixed handling of subchart CRDs when disabled
Security
  • Signed release binaries (GPG key 672C657B…)
Deprecated None for this release

For a quick start, see the Quickstart Guide. Detailed installation steps are in the install guide.

What are the major change groups in Helm 3.8?

OCI Registry Enhancements

  • OCI support is now generally available, removing the experimental flag.
  • Dependencies can specify OCI charts with version ranges, just like Helm repo charts.
  • Build metadata in SemVer tags is preserved; Helm converts “+” to “_” for registry storage.
  • helm registry login follows Docker CLI conventions and shares the same config file.

CLI and Search Improvements

  • The new --list-repo-url flag quickly shows repository URLs in helm search hub.
  • Release names are now validated during helm install, preventing illegal names early.

Platform and Compatibility Updates

  • Helm can be installed on Windows via Cygwin, expanding Windows developer support.
  • Full compatibility with Kubernetes 1.23, aligning with the latest API versions.

Stability and Bug Fixes

  • Resolved several OCI‑related panics and memory leaks.
  • Improved handling of subchart CRDs when subcharts are disabled.
  • General clean‑up of error messages and edge‑case handling.

FAQ

How do I reference an OCI chart with a version range?
Use the same syntax as a normal repo dependency, e.g. version: ">=1.2.0 <2.0.0" in the Chart.yaml dependencies block.

Will my existing helm registry login commands still work?
Yes. The command now mirrors Docker CLI behavior, and it reads the same config.json file Docker uses, so existing credentials are reused automatically.

Can I still push charts with a “+” in the tag?
OCI registries reject “+”. Helm automatically converts “+” to “_” when storing the tag, and reverses the conversion on pull, so the workflow remains seamless.

Do I need to change anything to support Kubernetes 1.23?
No code changes are required; Helm 3.8 includes the updated client libraries that understand the 1.23 API surface.

What should I do if I encounter a release-name validation error?
Ensure the name matches the allowed pattern (lowercase alphanumeric and “-”). The validation now runs before any resources are created, giving immediate feedback.

Releases In Branch 3.8

VersionRelease date
3.8.213 Apr 2022
(4 years ago)
3.8.024 Jan 2022
(4 years ago)