Secret:类型、消费与安全边界
Week 3 · 配置与密钥 · 2026-09-02
一、Secret 与 ConfigMap 的本质区别
| ConfigMap | Secret | |
|---|---|---|
data 值形态 | 明文 | base64 编码 |
| 用途 | 非敏感配置 | 密码 / token / 证书 |
| 安全属性 | 无 | base64 是编码不是加密,防君子不防小人 |
核心结论:base64 能一条命令还原,所以 Secret 的真正防线是 RBAC(谁能 get secret),不是编码本身。
还原明文:
kubectl get secret db-cred -o jsonpath='{.data.password}' | base64 -d; echo
二、Secret 类型(概述页表格,CKA 考前两种)
| 类型 | 创建命令 | 用途 |
|---|---|---|
| Opaque | kubectl create secret generic | 通用键值,默认类型 |
| kubernetes.io/tls | kubectl create secret tls | TLS 证书 |
| kubernetes.io/docker-registry | kubectl create secret docker-registry | 镜像仓库凭据 |
| kubernetes.io/service-account-token | 自动生成 | SA 令牌 |
三、创建方式
1. generic(命令行,考试最快)
kubectl create secret generic db-cred \
--from-literal=username=admin \
--from-literal=password='S3cret!'
2. stringData 免编码写法
apiVersion: v1
kind: Secret
metadata:
name: db-cred2
type: Opaque
stringData:
username: admin
password: "S3cret!"
stringData是创建时的明文输入,API Server 写入时自动转 base64 存进data- 转码后
stringData字段不持久化(get -o jsonpath='{.stringData.password}'返回空) - ⚠️ 坑:明文会残留进
metadata.annotations["kubectl.kubernetes.io/last-applied-configuration"]注解里。严格保密场景应自己 base64 后直接写data,避开stringData。
四、消费方式
env 注入(结构与 configMapKeyRef 同构)
env:
- name: DB_USER
valueFrom:
secretKeyRef:
name: db-cred
key: username
注入的是解码后的明文。
volume 挂载
volumeMounts:
- name: secret-volume
mountPath: /etc/secret
readOnly: true
volumes:
- name: secret-volume
secret:
secretName: db-cred
defaultMode: 0400 # Secret 默认 0400,ConfigMap 默认 0644
- 每个 key 一个文件,内容已解码为明文
subPath挂载单个 key:subPath: password(注意 subPath 不热更新)
五、tls 类型
openssl req -x509 -newkey rsa:2048 -nodes \
-keyout tls.key -out tls.crt -days 365 \
-subj "/CN=example.com"
kubectl create secret tls my-tls --cert=tls.crt --key=tls.key
type: kubernetes.io/tlsdata固定只有两个 key:tls.crt和tls.key- 考题出现 HTTPS / 证书 / ingress → 条件反射用
create secret tls
六、踩坑实录
kubectl run遗留 args 导致 CrashLoop:kubectl run pod --image=busybox自动带出args: [<pod名>],手写command: ["sleep","3600"]没删 args,最终执行sleep 3600 pod名→ sleep 报 invalid number 退出 →Error+BackOff循环重启。- stringData 明文泄漏进注解(见三·2)。
- echo 不带 -n 的换行坑:
echo 'admin' | base64会多编一个换行(尾部Cg==),Pod 拿到admin\n登录必挂。编码用echo -n,可疑值用cat -A看尾随$。
两种“Pod 起不来”分诊:
- 卡
ContainerCreating/CreateContainerConfigError→ 配置解析失败(引用不存在的 Secret/ConfigMap 或 key) Error+BackOff→ 容器启动后进程自身退出,查kubectl logs --previous
七、复习题(答案)
- Secret
data与 ConfigMapdata本质区别?—— Secret 是 base64 编码,ConfigMap 是明文;base64 是编码不是加密。 stringData与data的关系?—— stringData 是创建时明文输入,API Server 写入时转 base64 存 data;stringData 不持久化。- env / volume 拿到的值形态?volume 默认权限?—— 都是明文;volume 默认 0400。
- 创建 TLS Secret 的命令与固定 key?——
kubectl create secret tls my-tls --cert=tls.crt --key=tls.key;固定 key 为tls.crt、tls.key。