diff --git a/docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md b/docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md index 0fb1fb54a82..080040c64c0 100644 --- a/docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md +++ b/docs/getting-started/installation-and-upgrade/resources/helm-version-requirements.md @@ -12,7 +12,24 @@ This section contains the requirements for Helm, which is the tool used to insta +## 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.16.0 or higher is required for Kubernetes v1.16. For the default Kubernetes version, refer to the [release notes](https://github.com/rancher/rke/releases) for the version of RKE that you are using. -- Helm v2.15.0 should not be used, because of an issue with converting/comparing numbers. -- Helm v2.12.0 should not be used, because of an issue with `cert-manager`. +- 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. diff --git a/versioned_docs/version-2.10/getting-started/installation-and-upgrade/resources/helm-version-requirements.md b/versioned_docs/version-2.10/getting-started/installation-and-upgrade/resources/helm-version-requirements.md index 0fb1fb54a82..a4915a75d40 100644 --- a/versioned_docs/version-2.10/getting-started/installation-and-upgrade/resources/helm-version-requirements.md +++ b/versioned_docs/version-2.10/getting-started/installation-and-upgrade/resources/helm-version-requirements.md @@ -12,7 +12,24 @@ This section contains the requirements for Helm, which is the tool used to insta +## 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.10.8, which supports Kubernetes versions v1.28 through v1.31. +- **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.31. +- **Result:** You find that Helm v3.16 support the Kubernetes v1.28-v1.31 range. +- We recommend Helm v3.16 because matches Rancher's range exactly. + +## Additional Notes + - Helm v3.2.x or higher is required to install or upgrade Rancher v2.5. -- Helm v2.16.0 or higher is required for Kubernetes v1.16. For the default Kubernetes version, refer to the [release notes](https://github.com/rancher/rke/releases) for the version of RKE that you are using. -- Helm v2.15.0 should not be used, because of an issue with converting/comparing numbers. -- Helm v2.12.0 should not be used, because of an issue with `cert-manager`. +- 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. diff --git a/versioned_docs/version-2.11/getting-started/installation-and-upgrade/resources/helm-version-requirements.md b/versioned_docs/version-2.11/getting-started/installation-and-upgrade/resources/helm-version-requirements.md index 0fb1fb54a82..77a69ed4d1c 100644 --- a/versioned_docs/version-2.11/getting-started/installation-and-upgrade/resources/helm-version-requirements.md +++ b/versioned_docs/version-2.11/getting-started/installation-and-upgrade/resources/helm-version-requirements.md @@ -12,7 +12,24 @@ This section contains the requirements for Helm, which is the tool used to insta +## 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 v1.30 through v1.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.16.0 or higher is required for Kubernetes v1.16. For the default Kubernetes version, refer to the [release notes](https://github.com/rancher/rke/releases) for the version of RKE that you are using. -- Helm v2.15.0 should not be used, because of an issue with converting/comparing numbers. -- Helm v2.12.0 should not be used, because of an issue with `cert-manager`. +- 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. diff --git a/versioned_docs/version-2.12/getting-started/installation-and-upgrade/resources/helm-version-requirements.md b/versioned_docs/version-2.12/getting-started/installation-and-upgrade/resources/helm-version-requirements.md index 0fb1fb54a82..77a69ed4d1c 100644 --- a/versioned_docs/version-2.12/getting-started/installation-and-upgrade/resources/helm-version-requirements.md +++ b/versioned_docs/version-2.12/getting-started/installation-and-upgrade/resources/helm-version-requirements.md @@ -12,7 +12,24 @@ This section contains the requirements for Helm, which is the tool used to insta +## 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 v1.30 through v1.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.16.0 or higher is required for Kubernetes v1.16. For the default Kubernetes version, refer to the [release notes](https://github.com/rancher/rke/releases) for the version of RKE that you are using. -- Helm v2.15.0 should not be used, because of an issue with converting/comparing numbers. -- Helm v2.12.0 should not be used, because of an issue with `cert-manager`. +- 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. diff --git a/versioned_docs/version-2.9/getting-started/installation-and-upgrade/resources/helm-version-requirements.md b/versioned_docs/version-2.9/getting-started/installation-and-upgrade/resources/helm-version-requirements.md index 0fb1fb54a82..b7c961f3969 100644 --- a/versioned_docs/version-2.9/getting-started/installation-and-upgrade/resources/helm-version-requirements.md +++ b/versioned_docs/version-2.9/getting-started/installation-and-upgrade/resources/helm-version-requirements.md @@ -12,7 +12,24 @@ This section contains the requirements for Helm, which is the tool used to insta +## 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.9.10, which supports Kubernetes versions v1.27 through v1.30. +- **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.30. +- **Result:** You find that Helm v3.15 support the Kubernetes v1.27-v1.30 range. +- We recommend Helm v3.15 because matches Rancher's range exactly. + +## Additional Notes + - Helm v3.2.x or higher is required to install or upgrade Rancher v2.5. -- Helm v2.16.0 or higher is required for Kubernetes v1.16. For the default Kubernetes version, refer to the [release notes](https://github.com/rancher/rke/releases) for the version of RKE that you are using. -- Helm v2.15.0 should not be used, because of an issue with converting/comparing numbers. -- Helm v2.12.0 should not be used, because of an issue with `cert-manager`. +- 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.