Skip to main content

Helm Chart 中如何根據條件來動態安裝 Template 內的物件

· 2 min read
HungWei Chiu

Helm Chart 中可以透過各種 if/else 的語法將物件給包裹起來，這個操作會影響最後安裝過程中 該物件會不會被產出並且安裝到目標叢集中，因此大部分都是都過 Values 裡面的 enable/disable 等參數來調整。

但是如果今天該物件的安裝條件則是根據 K8s 版本而定，特別是當某些 API 於新版被移除時，這時候要如何撰寫一個兼容兩個版本的 Helm Chart。 舉例來說，以最近被移除的 PSP(PodSecurityPolicy) 物件為範例。

  1. 第一個做法就是維護兩個版本的 Helm Chart，針對新版的 Kubernetes 推進新版本，移除 PSP 物件並且針對 k8s 版本限制最低版本，舊 k8s 叢集不支援
  2. 使用 Helm 內建語法 .Capabilities.APIVersions.Has 去判斷目標 K8s API Resource 是否有包含目標版本

以 kube-prometheus-stack 為範例 其 psp-clusterorle.yaml 中的開頭使用了下列語法

{{- if and .Values.prometheus.enabled .Values.global.rbac.create .Values.global.rbac.pspEnabled }}
{{- if .Capabilities.APIVersions.Has "policy/v1beta1/PodSecurityPolicy" }}
kind: ClusterRole
...
{{- end }}
{{- end }}

透過 .Capabilities.APIVersions.Has 語法去判斷該物件是否支援，若支援則安裝否則跳掉，這機制帶來的好處就是可以打造出一個兼容更多版本 K8s 叢集的 Helm Chart，但是實務上真的需要這樣控管？還是應該要用不同版本的來管理會更好應該就見仁見智。