如何配置Helm模板仅渲染单个Worker Deployment实例

问题背景 #

现有values.yml包含两个Worker配置：

workers:
  - name: default-worker
    metadata:
      name: default
      component: web-server
    serviceAccountName: default-worker-account
  - name: data-worker
    metadata:
      name: data
      component: web-server
    serviceAccountName: data-worker-account

当前的Deployment模板通过range遍历所有Worker，会生成两个Deployment实例，但实际需求只需要渲染其中一个（比如data-worker对应的实例）。

解决方案 #

方法1：在遍历中添加条件过滤

直接修改Deployment模板，在range内部增加判断，只处理名称匹配的Worker：

{{- if $.Values.workers -}}
{{- range $worker := $.Values.workers -}}
{{- if eq $worker.name "data-worker" -}}
{{- $fullName := printf "%s-%s" (include "chart-app.fullname" $) $worker.name -}}
{{- $name := printf "%s-%s" (include "chart-app.name" $) $worker.name -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ $fullName }}
# 此处补充完整的Deployment配置内容
{{- end -}}
{{- end -}}
{{- end -}}

原理：通过eq $worker.name "data-worker"筛选出目标Worker，其他Worker会被跳过，最终只生成对应实例。

方法2：通过Values参数动态控制

如果需要灵活切换要渲染的Worker，可以在values.yml中新增配置项，模板根据该配置过滤：

1. 在values.yml中添加启用列表：

enabledWorkers: ["data-worker"] # 指定需要渲染的Worker名称

2. 修改Deployment模板：

{{- if $.Values.workers -}}
{{- range $worker := $.Values.workers -}}
{{- if has $worker.name $.Values.enabledWorkers -}}
{{- $fullName := printf "%s-%s" (include "chart-app.fullname" $) $worker.name -}}
{{- $name := printf "%s-%s" (include "chart-app.name" $) $worker.name -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ $fullName }}
# 此处补充完整的Deployment配置内容
{{- end -}}
{{- end -}}
{{- end -}}

原理：通过has函数检查当前Worker是否在启用列表中，后续只需修改enabledWorkers即可切换目标Worker，无需改动模板代码。

方法3：单独创建目标Worker的模板（适合固定需求）

如果长期只需要data-worker，可以单独为其创建模板文件，避免遍历逻辑：

新建data-worker-deployment.yaml模板：

{{- /* 从Values中查找指定名称的Worker */ -}}
{{- $targetWorker := first (filter $.Values.workers (lambda $w (eq $w.name "data-worker"))) -}}
{{- if $targetWorker -}}
{{- $fullName := printf "%s-%s" (include "chart-app.fullname" $) $targetWorker.name -}}
{{- $name := printf "%s-%s" (include "chart-app.name" $) $targetWorker.name -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ $fullName }}
# 此处补充完整的Deployment配置内容
{{- end -}}

原理：直接通过filter函数从Values中定位到目标Worker，无需遍历所有项，逻辑更直接。

内容的提问来源于stack exchange，提问作者Dedy Puji