ConfigMap 与 Secret

从订单服务的环境配置出发,理解 ConfigMap 与 Secret,学会将配置交给 Node.js 容器,并验证更新何时生效。

🎯 引言

我们已经把 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 订单镜像

代码和镜像保持不变

ConfigMap

普通配置

APP_VERSION=v1
Secret

敏感配置

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 镜像的情况下提供配置,并且理解了配置更新何时会生效。