密码学与证书 / 系统课时
理解 Kubernetes TLS Secret
理解 Kubernetes TLS Secret
Kubernetes 的 TLS Secret 只是把证书与私钥作为受控数据交给 Pod,并不会自动完成证书签发、应用热加载或最小权限设计。本课从 tls.crt、tls.key 开始,完成创建、挂载、验证,并解释更新传播和访问边界。
学习目标
- 识别
kubernetes.io/tlsSecret 的固定键与数据含义 - 将 TLS Secret 以只读卷挂载到 Pod 并验证文件可读
- 解释 Secret 更新为何不会等价于应用立即使用新证书
TLS Secret 保存什么
类型为 kubernetes.io/tls 的 Secret 约定包含 tls.crt 与 tls.key 两个键。tls.crt 通常保存 PEM 编码的证书链,tls.key 保存与叶子证书匹配的私钥。Secret API 中的 data 字段使用 Base64 表示二进制数据,Base64 不是加密。
Kubernetes API 对这种 Secret 类型主要检查所需键是否存在;证书是否过期、SAN 是否正确、证书链是否完整,以及应用是否能热加载新证书,仍需要由签发系统、准入策略、控制器或应用侧验证来保证。
创建并核对 TLS Secret
准备一对已经验证过的 server.crt 与 server.key 后,可以用 kubectl 创建 TLS Secret。下面命令同时创建演示命名空间并确认 Secret 类型。
kubectl create namespace demo
kubectl -n demo create secret tls web-tls --cert=server.crt --key=server.key
kubectl -n demo get secret web-tls -o custom-columns=NAME:.metadata.name,TYPE:.type --no-headers预期输出:
namespace/demo created
secret/web-tls created
web-tls kubernetes.io/tls若 demo 或 web-tls 已存在,对应创建命令会报 AlreadyExists;这不是证书错误,应根据实际环境改用更新流程,而不是重复创建。
挂载到 Pod 并验证
TLS Secret 最常见的消费方式是 Secret Volume。下面清单把两个键投射到 /etc/tls,设置只读挂载,并把文件默认权限限制为 0400。这是完整可应用的演示 Pod。
apiVersion: v1
kind: Pod
metadata:
name: tls-reader
namespace: demo
spec:
containers:
- name: reader
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
volumeMounts:
- name: tls
mountPath: /etc/tls
readOnly: true
volumes:
- name: tls
secret:
secretName: web-tls
defaultMode: 0400将内容保存为 tls-reader.yaml 后执行:
kubectl apply -f tls-reader.yaml
kubectl -n demo wait --for=condition=Ready pod/tls-reader --timeout=60s
kubectl -n demo exec tls-reader -- sh -c 'for f in /etc/tls/tls.crt /etc/tls/tls.key; do test -r "$f" && echo "$(basename "$f"): readable"; done'预期输出:
pod/tls-reader created
pod/tls-reader condition met
tls.crt: readable
tls.key: readable实际 Pod 创建状态文本可能因对象已存在而显示 configured 或 unchanged;关键验收点是 Pod Ready,且容器能读取两个目标文件。

更新传播不是即时热更新
当 Secret 对象被更新后,kubelet 会在后续同步中把新内容传播到普通 Secret Volume。这个过程不是严格即时的,延迟取决于 kubelet 的同步与变更检测策略。应用还必须重新读取文件或执行 TLS reload;如果进程只在启动时加载证书,卷里的文件即使已经变化,服务仍可能继续使用旧证书。
使用 subPath 挂载 Secret 的单个文件时,运行中的容器不会自动收到 Secret 更新。把 Secret 注入环境变量也不会在 Pod 运行期间自动刷新。因此需要证书自动轮换时,优先使用完整 Secret Volume,并确认应用支持文件监听、周期重读或显式 reload。
权限边界要分两层看
第一层是 Kubernetes API 权限。能 get、list 或 watch Secret 的主体可能读取敏感数据,因此应使用最小化 RBAC,并在集群侧启用适当的 etcd 静态数据加密和审计。不要把“Secret”对象名称误解为默认已经加密存储。
第二层是 Pod 内访问权限。只把 Secret 挂载给确实需要它的容器,设置 readOnly: true 与合适的文件模式,并结合容器运行用户和 SecurityContext 限制读取范围。defaultMode 只决定投射文件的权限位,不替代 API 级 RBAC,也不能阻止拥有更高容器或节点权限的主体读取数据。
一个可用的 Kubernetes TLS Secret 方案必须同时满足三点:API 侧只有授权主体能取得 Secret,Pod 侧只有需要证书的进程能读取私钥,更新链路还要保证应用最终切换到新证书。只完成 kubectl create secret tls 远远不等于完成证书生命周期管理。