Helm バージョンサポートポリシー

このドキュメントでは、Helm と Kubernetes 間でサポートされる最大バージョン差について説明します。

サポートされているバージョン

Helm のバージョンは x.y.z の形式で表されます。ここで、x はメジャーバージョン、y はマイナーバージョン、z はパッチバージョンを表し、セマンティックバージョニングの用語に従っています。

Helm プロジェクトでは、最新のマイナーリリースに対応するリリースブランチを維持しています。重大度と実現可能性に応じて、セキュリティ修正を含む対象の修正がリリースブランチに取り込まれます。詳細は Helm のリリースポリシーを参照してください。

サポートされるバージョン差

Helm の新しいバージョンがリリースされると、特定のマイナーバージョンの Kubernetes に対してコンパイルされます。たとえば、Helm 3.0.0 は Kubernetes 1.16.2 クライアントを使用して Kubernetes と通信するため、Kubernetes 1.16 と互換性があります。

Helm 3 以降では、コンパイル対象となった Kubernetes のバージョンを基準に、そこから 3 つ前のマイナーバージョン（n-3）までの互換性が想定されています。Kubernetes はマイナーバージョン間で変更が発生するため、Helm 2 のサポートポリシーはやや厳格であり、1 つ前のバージョン（n-1）までの互換性が想定されています。

たとえば、Kubernetes 1.17 クライアント API に対してコンパイルされた Helm 3 のバージョンを使用している場合、Kubernetes 1.17、1.16、1.15、1.14 で安全に使用できます。Kubernetes 1.16 クライアント API に対してコンパイルされた Helm 2 のバージョンを使用している場合は、Kubernetes 1.16 と 1.15 で安全に使用できます。

Helm がコンパイル対象となったバージョンよりも新しいバージョンの Kubernetes で使用することは推奨されません。Helm は前方互換性を保証していないためです。

Helm がサポートしていないバージョンの Kubernetes で Helm を使用する場合は、自己責任でご利用ください。

クラスターと互換性のある Helm バージョンを確認するには、以下の表を参照してください。

Helm バージョン	サポートされている Kubernetes バージョン
3.20.x	1.35.x - 1.32.x
3.19.x	1.34.x - 1.31.x
3.18.x	1.33.x - 1.30.x
3.17.x	1.32.x - 1.29.x
3.16.x	1.31.x - 1.28.x
3.15.x	1.30.x - 1.27.x
3.14.x	1.29.x - 1.26.x
3.13.x	1.28.x - 1.25.x
3.12.x	1.27.x - 1.24.x
3.11.x	1.26.x - 1.23.x
3.10.x	1.25.x - 1.22.x
3.9.x	1.24.x - 1.21.x
3.8.x	1.23.x - 1.20.x
3.7.x	1.22.x - 1.19.x
3.6.x	1.21.x - 1.18.x
3.5.x	1.20.x - 1.17.x
3.4.x	1.19.x - 1.16.x
3.3.x	1.18.x - 1.15.x
3.2.x	1.18.x - 1.15.x
3.1.x	1.17.x - 1.14.x
3.0.x	1.16.x - 1.13.x
2.16.x	1.16.x - 1.15.x
2.15.x	1.15.x - 1.14.x
2.14.x	1.14.x - 1.13.x
2.13.x	1.13.x - 1.12.x
2.12.x	1.12.x - 1.11.x
2.11.x	1.11.x - 1.10.x
2.10.x	1.10.x - 1.9.x
2.9.x	1.10.x - 1.9.x
2.8.x	1.9.x - 1.8.x
2.7.x	1.8.x - 1.7.x
2.6.x	1.7.x - 1.6.x
2.5.x	1.6.x - 1.5.x
2.4.x	1.6.x - 1.5.x
2.3.x	1.5.x - 1.4.x
2.2.x	1.5.x - 1.4.x
2.1.x	1.5.x - 1.4.x
2.0.x	1.4.x - 1.3.x