主题
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: 数据卷挂载 volumeMountscallout
- **命令行创建 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.comC 环境变量注入 vs 卷挂载全景对比
| 核心考量维度 | 环境变量方式 (env / envFrom) | 存储卷方式 (volumeMounts) |
|---|---|---|
| 语法实现 | valueFrom.configMapKeyRef | volumes.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 变动,自动滚动更新 PodE 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,并定期自动轮换刷新,大幅提升安全基线!