密码学与证书 / 系统课时

理解 Kubernetes TLS Secret

理解 Kubernetes TLS Secret

Kubernetes 的 TLS Secret 只是把证书与私钥作为受控数据交给 Pod,并不会自动完成证书签发、应用热加载或最小权限设计。本课从 tls.crt、tls.key 开始,完成创建、挂载、验证,并解释更新传播和访问边界。

学习目标

  • 识别 kubernetes.io/tls Secret 的固定键与数据含义
  • 将 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 类型。

bash
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

预期输出:

text
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。

yaml
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 后执行:

bash
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'

预期输出:

text
pod/tls-reader created
pod/tls-reader condition met
tls.crt: readable
tls.key: readable

实际 Pod 创建状态文本可能因对象已存在而显示 configured 或 unchanged;关键验收点是 Pod Ready,且容器能读取两个目标文件。

Kubernetes TLS Secret 挂载与更新传播数据流

更新传播不是即时热更新

当 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 远远不等于完成证书生命周期管理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 Kubernetes TLS Secret

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通