如何在Kubernetes资源YAML规格中指定数组与映射？

算力阿峰

2026-7-25

Kubernetes环境变量传递列表与映射的问题解答

问题场景

你尝试在Kubernetes的Application资源规格中传递列表类型的环境变量，YAML内容如下：

---
apiVersion: v1
kind: Application
metadata:
  name: my-app
spec:
  env:
    - name: ENV1
      value: http://someurl.com
    - name: ENV2
      value: val2

    - name: AN_ENV_LIST
      value:
        - val2
        - val3

但遇到错误：

invalid type for v1.Application.spec.env.value: got "array", expected "string"

问题解答

1. 这种用法是否支持？

不支持。从错误信息可以明确，v1.Application.spec.env.value字段的类型被定义为字符串，无法直接接收数组（列表）类型的值。

2. 如何指定列表？

有两种常用解决方式：

将列表转为字符串格式传递：把列表元素用逗号、空格等分隔符拼接成单个字符串，应用程序在内部再将字符串解析为列表。示例：
```
- name: AN_ENV_LIST
  value: "val2,val3"
```
借助ConfigMap/Secret传递：先将列表内容存入ConfigMap（或Secret），再通过envFrom字段从ConfigMap中导入环境变量。比如先创建ConfigMap：
```
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-env-config
data:
  AN_ENV_LIST: "val2,val3"
```
然后在Application的spec中引用：
```
spec:
  envFrom:
    - configMapRef:
        name: app-env-config
```

3. 是否支持映射类型？

同样不支持直接传递映射（键值对）类型给value字段，因为它仅接收字符串。可以通过以下方式实现需求：

将映射转为JSON字符串传递：把映射序列化为JSON格式的字符串，应用程序内部解析JSON得到映射。示例：
```
- name: AN_ENV_MAP
  value: '{"key1": "val1", "key2": "val2"}'
```
借助ConfigMap/Secret拆分传递：把映射的每个键值对作为ConfigMap的单独条目，通过envFrom导入，这样每个键会成为一个独立的环境变量。示例ConfigMap：
```
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-map-config
data:
  MAP_KEY1: "val1"
  MAP_KEY2: "val2"
```
然后在Application中引用即可。