大网数据广告活动
Kubernetes 部署与运维

使用 Init 容器定义环境变量值

· 52CE 我爱测

在本练习中,你将创建从文件中获取环境变量的 Pod,并将这些环境变量值投射到正在运行的容器中。

本页展示如何通过文件为 Pod 中的容器配置环境变量。

设计原理 {#how-the-design-works}

在本练习中,你将创建从文件中获取环境变量的 Pod,并将这些环境变量值投射到正在运行的容器中。

在上述清单中,你可以看到 initContainer 挂载一个 emptyDir 卷, 并将环境变量写入到其中的某个文件, 而普通容器无需挂载卷,通过 fileKeyRef 字段引用此文件和环境变量键。 当 optional 字段设置为 false 时,fileKeyRef 中指定的 key 必须存在于环境变量文件中。

此卷只会挂载到写入文件的容器(initContainer)中,而使用环境变量的容器将不挂载此卷。

环境变量文件格式遵循 Kubernetes Env 文件标准。

在容器初始化期间,kubelet 从 emptyDir 卷中指定的文件中获取环境变量, 并将这些环境变量暴露给容器。

所有类型的容器(initContainers、普通容器、边车容器和临时容器)都支持从文件加载环境变量。

虽然这些环境变量可以存储敏感信息,但 emptyDir 卷并不提供与专用 Secret 对象相同的保护机制。 因此,通过此特性向容器暴露机密环境变量不被视为安全最佳实践。

创建 Pod:

kubectl apply -f https://k8s.io/examples/pods/inject/envars-file-container.yaml

验证 Pod 中的容器是否在运行:

# 如果新 Pod 尚未就绪,多次运行此命令。
kubectl get pods

检查容器日志中的环境变量:

kubectl logs envfile-test-pod -c use-envfile | grep DB_ADDRESS

输出显示所选环境变量的值:

DB_ADDRESS=address

Env 文件语法 {#env-file-syntax}

Kubernetes 使用的 Env 文件格式是符合 POSIX 标准的 Bash 环境变量语义的一个定义明确的子集。 Kubernetes 所支持的所有 Env 文件都会生成与被符合 POSIX 标准的 Bash 解释时相同的环境变量。但是,符合 POSIX 标准的 Bash 支持一些 Kubernetes 不接受的额外格式。

事例:

MY_VAR='my-literal-value'

规则

  • 变量声明:使用 VAR='value' 的形式。= 前后空格将被忽略;行首空格将被忽略;空行将被忽略。
  • 带引号的值:值必须用单引号(')括起来。
    • 单引号内的内容将按原样保留。不会进行转义序列处理、空格折叠或字符解释。
    • 单引号内的换行符将被保留(支持多行值)。
  • 注释:以 # 开头的行将被视为注释并被忽略。单引号内的值中的 # 字符不是注释。

事例:

# comment
DB_ADDRESS='address'

MULTI='line1
line2'

不支持的表单

  • 禁止使用未加引号的值:
    • VAR=value — 不支持。
  • 禁止使用双引号的值:
    • VAR="value" — 不支持。
  • 禁止使用多个相邻的带引号的字符串:
    • VAR='val1''val2' — 不支持。
  • 禁止使用任何形式的插值、扩展或连接:
    • VAR='a'$OTHER 或 VAR=${OTHER} — 不支持。

严格的单引号要求确保 kubelet 在从文件中加载环境变量时,能够按字面意思理解该值。

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。