如何通过Helm的values.yaml批量配置Kubernetes中Java应用的环境变量

要实现仅通过修改Helm的values-xxx.yaml文件来管理不同环境的批量环境变量，只需在Deployment模板中添加循环逻辑遍历values.yaml里的env键值对即可，具体步骤如下：

1. 维护多环境values文件 #

保留现有values.yaml作为基础配置，为每个环境创建对应的values-dev.yaml、values-staging.yaml等文件，在其中覆盖或新增环境专属变量：

values.yaml（基础配置）

env:
  VARIABLE_1: VALUE_1
  VARIABLE_2: VALUE_2
  VARIABLE_3: VALUE_3
  # 更多通用变量...

values-dev.yaml（开发环境配置）

env:
  # 覆盖基础配置中的变量值
  VARIABLE_1: DEV_VALUE_1
  VARIABLE_2: DEV_VALUE_2
  # 新增开发环境专属变量
  DEV_SPECIFIC_VAR: "dev-only-value"

values-staging.yaml（预发布环境配置）

env:
  VARIABLE_1: STAGING_VALUE_1
  # 仅修改需要变更的变量，未提及的沿用values.yaml中的值

2. 修改Deployment模板，批量生成环境变量 #

在Helm Chart的deployment.yaml模板中，找到容器定义部分，用Helm的range循环遍历.Values.env的键值对，自动生成Kubernetes环境变量条目：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-java-app
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: java-app
  template:
    metadata:
      labels:
        app: java-app
    spec:
      containers:
      - name: java-app
        image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
        ports:
        - containerPort: 8080
        # 批量生成环境变量
        env:
        {{- range $key, $value := .Values.env }}
        - name: {{ $key }}
          value: {{ $value | quote }}
        {{- end }}

关键说明： #

• range $key, $value := .Values.env：遍历env下所有键值对，$key为变量名，$value为对应值
• quote函数：确保变量值包含特殊字符（如空格、引号）时仍生成合法YAML格式
• 环境专属values文件未提及的变量，自动沿用values.yaml的基础值

3. 部署不同环境 #

使用Helm部署时，通过-f参数指定对应环境的values文件即可：

# 部署开发环境
helm install my-java-app . -f values-dev.yaml

# 部署预发布环境
helm install my-java-app . -f values-staging.yaml

后续修改或增减变量，只需直接调整对应的values-xxx.yaml文件后重新部署，完全无需改动Deployment模板。

内容的提问来源于stack exchange，提问作者Honza Zidek