Skip to content

A 配置与镜像解耦哲学 ​

云原生十二要素应用(The Twelve-Factor App)第三条核心准则明确指出:严禁将配置硬编码在容器镜像中,配置必须在运行时从环境中注入。 Kubernetes 提供了两大核心配置抽象资源:

kv
ConfigMap: 明文存储业务配置、环境变量、启动参数与整个配置文件
Secret: 专职存储敏感凭据 (数据库密码、API Token、TLS 证书、私有镜像仓库凭证)
flow
[外部配置文件 application.properties] -> [kubectl create configmap]
[kubectl create configmap] -> [ConfigMap 资源存储于 etcd]
[ConfigMap 资源存储于 etcd] -> [挂载方式 1: 环境变量注入 env / envFrom]
[ConfigMap 资源存储于 etcd] -> [挂载方式 2: 数据卷挂载 volumeMounts]
[挂载方式 1: 环境变量注入 env / envFrom] -> [业务 Pod 容器]
[挂载方式 2: 数据卷挂载 volumeMounts] -> [业务 Pod 容器]
group 容器注入双轨链路: 挂载方式 1: 环境变量注入 env / envFrom, 挂载方式 2: 数据卷挂载 volumeMounts
callout
- **命令行创建 ConfigMap**:`kubectl create cm redis-conf --from-file=redis.conf`(从文件创建)或 `--from-literal=env=prod`(从键值对创建)。
- **在 YAML 中存放大段配置文件(如 `nginx.conf`)时的多行控制符**:
  - `|`:保留换行且保留文件末尾单个换行符(最常用,完美保留代码文件原有排版)。
  - `|+`:保留换行,且保留文件末尾的所有空行。
  - `|-`:保留换行,但剔除文件末尾的所有换行符。
  - `>`:折叠换行(将连续多行文本合并为空格分隔的单行长字符串)。
- **`subPath` 单文件挂载防覆盖技巧**:若直接将 ConfigMap 挂载到 `/etc/nginx`,会将容器内 `/etc/nginx` 原有的其他文件全部隐藏覆盖!配置 `mountPath: /etc/nginx/nginx.conf` 配合 `subPath: nginx.conf`,即可仅替换单个配置文件而不影响同目录其他文件(注意:使用 `subPath` 挂载的单文件不支持 Kubelet 自动热更新同步)。

B Secret 机密管理体系与三大常见类别 ​

虽然 Secret 默认仅采用 Base64 编码保存,但它具备更严格的 RBAC 访问权限隔离与内存挂载防护(基于 tmpfs)。

Secret 类型字段要求与数据结构典型生产应用场景
Opaque (默认通用型)data 存放 Base64 编码,stringData 允许直接写明文自动转码数据库账号密码、API 私钥
kubernetes.io/tls必须严格包含 tls.crt 与 tls.key 两个标准键Ingress 卸载 HTTPS、企业 SSL 证书
kubernetes.io/dockerconfigjson包含私有 Docker Registry 的 JSON 认证凭证imagePullSecrets 拉取私有镜像仓库
bash
# 从现有私有仓库凭证文件快速生成 Secret
kubectl create secret docker-registry my-registry-secret \
  --docker-server=registry.internal.com \
  --docker-username=admin \
  --docker-password=secretpass \
  --docker-email=devops@internal.com

C 环境变量注入 vs 卷挂载全景对比 ​

核心考量维度环境变量方式 (env / envFrom)存储卷方式 (volumeMounts)
语法实现valueFrom.configMapKeyRefvolumes.configMap + volumeMounts
形态表现容器内直接读取环境变量 $DB_HOST容器内映射为一个独立文件 /etc/conf/app.conf
粒度控制单键单值注入可挂载单文件(配合 subPath)或整目录
热更新能力完全不支持热更新!必须销毁重启容器支持异步热更新(Kubelet 自动同步文件修改)

D 配置热更新与 Reloader 自动刷新实战 ​

配置热更新的痛点: 即使通过 Volume 挂载的 ConfigMap 在修改后文件会自动同步更新,但大多数业务程序(如 Java、Node.js、Nginx)在启动后已将配置加载至内存,根本不会主动重新读取磁盘文件!

flow
[运维更新 ConfigMap] -> [Kubelet 监听到变更并在约 60s 内更新容器内文件]
[Kubelet 监听到变更并在约 60s 内更新容器内文件] -> [传统业务进程: 依然使用内存旧配置,无感知]
[运维更新 ConfigMap] -> [开源 Reloader 控制器: List-Watch 发现配置变动]
[开源 Reloader 控制器: List-Watch 发现配置变动] -> [Reloader 自动触发关联 Deployment 的 RollingUpdate]
[Reloader 自动触发关联 Deployment 的 RollingUpdate] -> (优雅滚动重启 Pod,无缝加载最新配置)
yaml
# 在 Deployment 注解中开启 Reloader 自动联动
metadata:
  annotations:
    reloader.stakater.com/auto: "true" # 只要关联的 ConfigMap 变动,自动滚动更新 Pod

E ServiceAccount 认证凭据与演进 (K8s 1.24+) ​

ServiceAccount (SA) 是 Pod 进程与集群 API Server 安全交互的“身份身份证”。

flow
[业务 Pod] -> [自动挂载目录 /var/run/secrets/kubernetes.io/serviceaccount/]: 读取 token 与 ca.crt
[业务 Pod] -> [API Server]: 携带 Bearer Token 发起内部管控请求
callout
- **旧版本机制 (≤ 1.23)**:创建一个 SA,Kubernetes 自动在后台创建一个永久不过期的静态 Secret 存放 Token,存在泄露失窃风险。
- **现代化演进 (≥ 1.24)**:创建 SA 绝不再自动生成静态 Secret!而是采用**投影卷 (Projected Volume)** 机制,由 TokenRequest API 在 Pod 启动时动态生成具备生命周期与绑定受众(Audience)的短期 Token,并定期自动轮换刷新,大幅提升安全基线!

← 返回 Kubernetes 知识库总索引