mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-05-15 17:43:37 +00:00
Dan P.
d0511be5c3
* Add details on selecting proper Helm 3 version * Simplify notes about helm V2 into a single bulletpoint * Add note about tools that use helm indirectly for users * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Update docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Sync new helm docs to versioned docs * Add helm info to 2.10/2.9 docs with updated example --------- Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com>
36 lines
2.5 KiB
Markdown
36 lines
2.5 KiB
Markdown
---
|
|
title: Helm Version Requirements
|
|
---
|
|
|
|
<head>
|
|
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/getting-started/installation-and-upgrade/resources/helm-version-requirements"/>
|
|
</head>
|
|
|
|
This section contains the requirements for Helm, which is the tool used to install Rancher on a high-availability Kubernetes cluster.
|
|
|
|
> The installation instructions have been updated for Helm 3. For migration of installs started with Helm 2, refer to the official [Helm 2 to 3 Migration Docs.](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/) [This section](https://github.com/rancher/rancher-docs/tree/main/archived_docs/en/version-2.0-2.4/getting-started/installation-and-upgrade/advanced-options/advanced-use-cases/helm2/helm2.md) provides a copy of the older high-availability Rancher installation instructions that used Helm 2, and it is intended to be used if upgrading to Helm 3 is not feasible.
|
|
|
|
<DeprecationHelm2 />
|
|
|
|
## Identifying the Proper Helm v3 Version
|
|
|
|
Select any Helm v3 version that is officially compatible with the Kubernetes version range you are using from our [Rancher Support Matrix](https://www.suse.com/suse-rancher/support-matrix/all-supported-versions).
|
|
|
|
To apply this rule, you may need to reference two external resources:
|
|
|
|
- **Helm Version Compatibility:** Refer to the [Helm Version Support Policy](https://helm.sh/docs/topics/version_skew/) and select the version matching the rule for your Rancher minor target.
|
|
- **Rancher's Kubernetes Support Range:** Use the [Rancher Support Matrix](https://www.suse.com/suse-rancher/support-matrix/all-supported-versions) to identify the Kubernetes versions supported by your target Rancher minor version.
|
|
|
|
### Example
|
|
|
|
- **Scenario:** You are targeting Rancher v2.11.4, which supports Kubernetes versions 1.30 through 1.32.
|
|
- **Application:** Our rule requires a Helm version that supports this range. You can verify this by checking the Helm version's compatibility with the highest version in the range, Kubernetes v1.32.
|
|
- **Result:** You find that both Helm v3.17 and Helm v3.18 support the Kubernetes v1.30-v1.32 range.
|
|
- Although both work, we recommend Helm v3.18 because it is the newest Helm minor version overlapping the supported Kubernetes range.
|
|
|
|
## Additional Notes
|
|
|
|
- Helm v3.2.x or higher is required to install or upgrade Rancher v2.5.
|
|
- Helm v2 support was removed in Rancher v2.9.x.
|
|
- When using tools that run Helm commands for you (like Terraform), you must make sure they are configured to use the correct Helm version.
|