ConfigMap 与 Secret
🎯 引言
我们已经把 Node.js 订单服务部署到了 Kubernetes。现在有一个新需求:开发环境使用 APP_VERSION=v1,以后可能改成 v2,应用还需要读取一个不应该公开的 DEMO_TOKEN。这里的 APP_VERSION 只是用来观察配置变化的标识, 不是 Node.js 应用代码的实际版本。
如果把这些值写死在代码里,每次修改配置都要改代码、重新构建镜像。有没有办法 不改订单服务镜像,只修改部署时使用的配置?
Kubernetes 提供了两种资源: ConfigMap 保存普通配置,Secret 保存敏感配置。本篇用同一个订单服务,一步步完成创建配置、交给容器、在 Node.js 中读取,以及修改后验证生效的过程。
🧱 为什么需要 ConfigMap 和 Secret
先记住它们的区别:
| 资源 | 存放什么 | 本篇示例 |
|---|---|---|
| ConfigMap | 普通配置,例如版本标识、服务地址 | APP_VERSION=v1 |
| Secret | 密码、Token 等敏感配置 | DEMO_TOKEN=local-only(仅供本地练习) |
两者都不是 Node.js 代码文件,也不会自己启动容器。我们会在 Deployment 中声明: 启动订单容器时,把这两个配置项作为环境变量提供给它。
订单服务怎样获得配置?
同一份 Node.js 订单镜像
代码和镜像保持不变
普通配置
APP_VERSION=v1敏感配置
DEMO_TOKEN=••••Deployment 引用配置
创建新 Pod 时,将值注入容器环境变量
Node.js 使用 process.env 读取
读取 APP_VERSION,检查 DEMO_TOKEN 是否存在
示意图展示的是配置注入关系,不是网络请求路径。
你只需要先理解这条关系: ConfigMap / Secret 保存值 → Deployment 引用它们 → 新 Pod 中的 Node.js 使用 process.env 读取值。
🛠 创建并查看配置
继续使用前面课程创建的 course Namespace 和 orders Deployment。先创建两份配置:
kubectl create configmap orders-config -n course --from-literal=APP_VERSION=v1
kubectl create secret generic orders-secret -n course --from-literal=DEMO_TOKEN=local-only
模拟输出:
configmap/orders-config created
secret/orders-secret created
第一条命令创建名为 orders-config 的 ConfigMap,其中有一个键 APP_VERSION,值为 v1。第二条命令创建名为 orders-secret 的 Secret,其中保存演示用的 DEMO_TOKEN。
确认资源存在即可,不需要把 Secret 的内容显示出来:
kubectl get configmap orders-config -n course
kubectl get secret orders-secret -n course
模拟输出:
NAME DATA AGE
orders-config 1 10s
NAME TYPE DATA AGE
orders-secret Opaque 1 10s
DATA=1 表示各有一个配置项。 创建成功只是把值保存到 Kubernetes,还没有交给订单服务;下一步才让 Deployment 使用它们。
local-only 是演示值。不要把真实密码或 Token 直接写在命令里:命令历史和进程参数可能泄露这些值。🧩 让订单容器读取配置
1. 在 Deployment 中引用配置
打开之前用于部署订单服务的 Deployment YAML,找到 containers 中的订单容器,在容器配置下添加 env。 下面只是原文件中的局部示例,不是可直接提交的完整 Deployment YAML。 只添加 env,原来的镜像、端口、副本数等配置保持不变:
spec:
template:
spec:
containers:
- name: orders
# image、ports 等已有字段保持原样
env:
- name: APP_VERSION
valueFrom:
configMapKeyRef:
name: orders-config
key: APP_VERSION
- name: DEMO_TOKEN
valueFrom:
secretKeyRef:
name: orders-secret
key: DEMO_TOKEN
如果之前的容器名称不是 orders,保持原名称,不要为了照抄示例而改名。env 应与该容器的 image、ports 等字段处于同一级,而不是写在 template 外面。
这里不需要记住所有字段,先看两组对应关系:
configMapKeyRef:从orders-config中取出APP_VERSION,交给容器内同名环境变量。secretKeyRef:从orders-secret中取出DEMO_TOKEN,交给容器内同名环境变量。
保存原 Deployment YAML,然后执行(将文件名替换为前面课程实际使用的路径):
kubectl apply -f deployment.yaml -n course
kubectl rollout status deployment/orders -n course
模拟输出:
deployment.apps/orders configured
deployment "orders" successfully rolled out
configured 表示 Deployment 配置发生了变化;等待滚动更新完成后,新 Pod 就会使用刚才声明的环境变量。
2. 直接用 Node.js 验证
先不修改 Express 接口。kubectl exec 能让我们从电脑终端,在正在运行的订单容器里执行命令。这里使用 node -e 直接执行一小段 JavaScript,读取容器拿到的配置;Boolean() 只检查 Token 是否有值,不会打印它的内容:
kubectl exec -n course deployment/orders -- \
node -e 'console.log({
version: process.env.APP_VERSION,
hasToken: Boolean(process.env.DEMO_TOKEN)
})'
模拟输出:
{ version: 'v1', hasToken: true }
这就是本篇最重要的验证结果:
version: 'v1'表示 Node.js 读到了 ConfigMap 的值。hasToken: true表示 Node.js 能读到 Secret 提供的变量;我们只检查它是否存在, 不打印 Token 的内容。
注意:环境变量虽然已经注入,但 Express 的 /api/info 接口 不会自动多出一个 APP_VERSION 字段。只有接口代码主动读取并返回这个值时,浏览器才会看到它。因此,本篇直接通过 process.env 验证,避免修改前面的业务接口。
🔄 修改 ConfigMap 后,为什么还是旧值?
假设现在想把版本标识从 v1 改成 v2,镜像不变,只修改 ConfigMap:
kubectl patch configmap orders-config -n course \
--type merge -p '{"data":{"APP_VERSION":"v2"}}'
模拟输出:
configmap/orders-config patched
修改 ConfigMap 后,先不重启订单服务,直接检查容器当前读到的版本标识:
kubectl exec -n course deployment/orders -- \
node -p 'process.env.APP_VERSION'
模拟输出:
v1
node -p 会直接输出表达式的结果。虽然 ConfigMap 已改成 v2,但正在运行的容器读到的仍然是 v1。
为什么没有立即变成 v2? 因为这里采用的是 环境变量注入:Pod 启动容器时取得配置,正在运行的 Node.js 进程不会因为 ConfigMap 更新而自动改写自己的环境变量。
所以,让 Deployment 创建使用新配置的 Pod:
kubectl rollout restart deployment/orders -n course
kubectl rollout status deployment/orders -n course
模拟输出:
deployment.apps/orders restarted
deployment "orders" successfully rolled out
等新的 Pod 就绪, 再次执行同一条检查命令:
kubectl exec -n course deployment/orders -- \
node -p 'process.env.APP_VERSION'
模拟输出:
v2
这次变成了 v2,因为新建的 Pod 在启动时读取了更新后的 ConfigMap。
整个过程可以记成一句话: 改 ConfigMap 只是改了保存的值;以环境变量方式使用它的旧容器不会自动更新,需要创建新 Pod 才能读取新值。
⚠️ Secret 能保证密码绝对安全吗?
不能。Secret 让敏感配置与普通配置分开管理,但 Secret 不等于默认加密,也不等于任何人都无法读取。
实际项目中,不要把真实密钥提交到 Git 仓库,不要在接口响应或日志中打印密钥;还需要通过访问权限、存储加密等措施保护 Secret。这些安全配置不影响本篇的核心操作,后续有需要再深入。
❓ 知识问答
Q:ConfigMap 和 Secret 会修改 Node.js 镜像吗?
不会。本篇修改的是 Kubernetes 中的配置和 Deployment,应用镜像不需要重新构建。
Q:为什么我创建了 ConfigMap,Node.js 却读不到?
因为创建资源不等于注入容器。需要在 Deployment 的 env 中引用配置,并让新的 Pod 使用更新后的配置。
Q:修改 Secret 后也需要重启吗?
如果像本篇一样通过环境变量注入,正在运行的容器也不会自动得到新值,通常需要让 Pod 重新创建。
🧪 小练习
独立将 orders-config 中的 APP_VERSION 从 v2 改成 v3,然后分别在 滚动重启前 和 滚动重启后,使用上面的 node -p 检查命令观察结果。
验收标准: 能看到重启前仍是旧值、重启后变为 v3;能解释 ConfigMap 和 Secret 各自保存什么,以及为什么不能把真实 Token 打印到日志或接口里。
🎉 恭喜你!你已经学会让 Kubernetes 在不重建 Node.js 镜像的情况下提供配置,并且理解了配置更新何时会生效。
