【 Kubernetes 风云录 】- Helm航行中的风浪

有时，根据多个条件进行动态配置是必需的，但 Helm 模板语法的条件逻辑可能会变得复杂。

解决方案： 使用 Go 模板的条件和函数，以及 Helm 的内建函数，如 if、 default、or、range 等，以更灵活地处理条件逻辑。

Range语法的坑

Before

{{- range $num,$tag := .Values.image.tag -}}
{{- $version := add $num 1 -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "grpc-manifest.fullname" . }}-v{{ $version }}
  labels:
    {{- include "grpc-manifest.labels" . | nindent 4 }}
    app.kubernetes.io/tag: v{{ $version }}
    app.kubernetes.io/type: grpc
spec:
  revisionHistoryLimit: {{ .Values.revisionHistoryLimit | default 5 }}
  {{- if not .Values.autoscaling.enabled }}
  replicas: {{ .Values.replicaCount }}
  {{- end }}
  selector:
    matchLabels:
      {{- include "grpc-manifest.selectorLabels" . | nindent 6 }}
      app.kubernetes.io/tag: v{{ $version }}
      app.kubernetes.io/type: grpc
 ......
 {{end }}

Error:

原因: 在 Range 内循环 . 的值。被设置为该值。您可以使用 $ 代替。 $ 是根数据对象的别名，并且在执行过程中不会改变, 导致没法渲染。

After

{{- $revisionHistoryLimit := .Values.revisionHistoryLimit -}}
{{- $replicaCount := .Values.replicaCount -}}
{{- $autoscaling := .Values.autoscaling.enabled -}}
{{- range $num,$tag := .Values.image.tag -}}
{{- $version := add $num 1 -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "grpc-manifest.fullname" $  }}-v{{ $version }}
  labels:
    {{- include "grpc-manifest.labels" $ | nindent 4 }}
    app.kubernetes.io/tag: v{{ $version }}
    app.kubernetes.io/type: grpc
spec:
  revisionHistoryLimit: {{ $revisionHistoryLimit | default 5 }}
  {{- if not $autoscaling }}
  replicas: {{ $replicaCount }}
  {{- end }}
  selector:
    matchLabels:
      {{- include "grpc-manifest.selectorLabels" $ | nindent 6 }}
      app.kubernetes.io/tag: v{{ $version }}
      app.kubernetes.io/type: grpc
 ......
 {{end }}

End 结尾的坑

在 Helm 模板中，{{- 和 {{- 以及-}} 和-}} 中的空格和破折号（减号）用于控制生成的文本格式和去除不必要的空格。这些被称为空白修饰符。

• {{- 和 -}} 会去除生成的文本中的空白，包括行尾空白和空行。它们分别放在标签的开头和结尾，确保在生成的文本中没有多余的空格。
• {{- 和 }} 的组合表示在生成文本中去除行尾空白，但在生成文本中保留行首空白。
• {{ 和 -}} 的组合表示在生成文本中去除行首空白，但在生成文本中保留行尾空白。
• {{- end -}} 表示在生成文本中去除与 end 标签相关的行首和行尾空白。

使用这些空白修饰符的目的是确保生成的文本在格式上更加清晰，避免在 Helm 模板中引入不必要的空白字符。在某些情况下，这些空白修饰符可以对生成的 YAML 文件产生实质性的影响，因为 YAML 对缩进和空白敏感。

集成 Helm 和 CI/CD 工作流

将 Helm 与 CI/CD 工具集成时，可能遇到构建、推送镜像、部署 Helm Chart 等步骤的协同问题。

解决方案： 建议直接使用 ArgoCD,它将 Git 存储库中描述的应用程序的状态与 Kubernetes 集群中的部署同步。

我们使用Helm作为服务发布的模板工具，因此我们需要有一个Git仓库来存放用于服务部署的声明性配置，这种配置我们称为Manifest，一个服务的Manifest就是一个Helm Chart。存放Manifest的仓库我们称为Manifest Repo。

多环境管理

在不同的环境中使用相同的 Helm Chart，但可能需要不同的配置和依赖。

解决方案： 使用 Helm 的 values 文件来区分不同环境的配置。

自定义函数和模板

有时，Helm 的内建函数无法满足需求，需要编写自定义函数或模板。

解决方案： 学习 Go 模板语言，编写自定义的 Helm 模板和函数，以满足特定的需求。

这些问题和解决方案只是 Helm Chart 定制过程中可能遇到的一小部分。深入理解 Helm 的原理和 Kubernetes 的工作方式，以及灵活运用 Helm 的功能，将帮助更好地应对更复杂的场景。