Pod
🎯 引言
上一篇我们用 kind 创建了 Kubernetes 集群,还学会了用 kubectl 查看节点、创建 Namespace。但集群里还没有运行自己的 Node.js 应用。
在 Docker 中,我们可以直接启动一个容器;在 Kubernetes 中,应用容器通常运行在 Pod 里。Pod 到底是什么?它和容器、Node 有什么区别?又该怎样确认应用已经运行,并从电脑上访问它?
本篇继续使用上一篇的 node-course 集群和 course Namespace,亲手运行一个简单的 Node.js 订单服务,完成 准备镜像 → 创建 Pod → 查看状态 → 访问应用 → 删除 Pod 的完整过程。每一步都附有模拟输出,即使暂时不操作,也能理解执行效果。
🧱 Pod 为什么存在
上一篇已经知道,Node 是集群中的机器。如果 Kubernetes 需要把订单服务安排到某个 Node 上运行,它实际安排的基本单位就是 Pod。
一个 Pod 中可以运行一个或多个容器。对于普通的 Node.js 服务,通常先按 一个 Pod 运行一个应用容器 来理解。
正在加载流程图…
从图中可以看到:
- Node 提供 CPU、内存等运行资源,一台 Node 可以运行多个 Pod。
- Pod 是 Kubernetes 部署和调度应用的基本单位,不是另一台服务器。
- Container(容器) 才是真正执行 Node.js 程序的地方。
为什么不是直接管理容器?因为 Kubernetes 需要一个统一的单位来安排应用运行,并为同一个 Pod 内的容器提供共同的运行环境。例如,同一个 Pod 内的容器共享网络空间,可以通过 localhost 访问彼此的端口。这篇只使用一个容器,不展开多容器场景。
需要先分清两种情况:Pod 里的容器进程退出,Kubernetes 通常会按重启策略尝试重启容器;但如果 手动删除一个没有控制器管理的 Pod,它不会自动重新创建。后面会实际验证第二种情况。
🛠 先准备可运行的订单镜像
Pod 需要知道运行什么镜像。为了让示例不依赖额外的下载链接,我们直接创建一个最小的 Express 订单服务。
如果你已经有课程配套的订单服务项目,也可以沿用它;但这篇的代码和后面的输出均以下面这个最小示例为准。
1. 创建 Node.js 项目
新建 orders-app 文件夹,放入以下文件:
orders-app/
├── package.json
├── server.js
└── Dockerfile
package.json:
{
"name": "course-orders",
"version": "1.0.0",
"private": true,
"type": "module",
"scripts": {
"start": "node server.js"
},
"dependencies": {
"express": "5.1.0"
}
}
server.js:
import express from 'express'
const app = express()
const port = 3000
app.get('/healthz', (req, res) => {
res.json({ status: 'ok' })
})
app.get('/api/info', (req, res) => {
res.json({ service: 'orders', version: 'v1' })
})
app.listen(port, '0.0.0.0', () => {
console.log(`订单服务已启动,监听端口 ${port}`)
})
这两个接口用途不同:/healthz 用于简单确认程序能响应请求;/api/info 用于查看当前运行的服务和版本。这里没有连接数据库,方便把注意力放在 Pod 上。
Dockerfile:
FROM node:22-alpine
WORKDIR /app
COPY package.json ./
RUN npm install --omit=dev
COPY server.js ./
EXPOSE 3000
CMD ["npm", "start"]
这份 Dockerfile 使用 Node.js 22 镜像,在容器内安装依赖、复制程序并启动服务。EXPOSE 3000 只是说明程序使用的端口,并不会自动把它开放到电脑上。为了让示例尽量短,这里不提供锁文件;实际项目更建议提交 package-lock.json 并使用 npm ci 构建。
2. 构建 Docker 镜像
确保 Docker 已启动,在 orders-app 目录执行:
docker build -t course-orders:v1 .
模拟输出(构建步骤和耗时因环境而异):
[+] Building ... FINISHED
=> [internal] load build definition from Dockerfile
=> [1/4] FROM docker.io/library/node:22-alpine
=> [2/4] WORKDIR /app
=> [3/5] COPY package.json ./
=> [4/5] RUN npm install --omit=dev
=> [5/5] COPY server.js ./
=> exporting to image
=> => naming to docker.io/library/course-orders:v1
其中 -t course-orders:v1 给镜像指定名称和版本标签;末尾的 . 表示使用当前目录作为构建上下文。看到构建成功,并出现 course-orders:v1 镜像名称,就可以继续。
上面只列出关键日志行,不代表 Docker 每次都输出完全一样的内容。
3. 把镜像加载到 kind 集群
虽然镜像已经构建在本机 Docker 中,但 kind 的节点有自己的容器镜像存储。要让 Kubernetes 节点找到它,还需要执行:
kind load docker-image course-orders:v1 --name node-course
模拟输出:
Image: "course-orders:v1" with ID "sha256:..." not yet present on node "node-course-control-plane", loading...
这表示 kind 正在把本机镜像加载到 node-course 集群节点。镜像 ID 会因构建结果而不同;重复加载时,输出也可能不一样。
这里不用镜像仓库,因为我们只在本地练习。后续 Pod 使用的镜像名称必须与这里一致。
🧩 写第一份 Pod 配置
在 orders-app 目录中新建 pod.yaml:
apiVersion: v1
kind: Pod
metadata:
name: orders-demo
namespace: course
labels:
app: orders
spec:
containers:
- name: orders
image: course-orders:v1
imagePullPolicy: IfNotPresent
ports:
- containerPort: 3000
上一篇已经认识 apiVersion、kind 和 metadata。这次重点看新增字段:
| 字段 | 作用 |
|---|---|
kind: Pod | 要创建的资源类型是 Pod |
metadata.name | Pod 的名称是 orders-demo |
metadata.namespace | 放到上一篇创建的 course Namespace 中 |
metadata.labels | 给 Pod 添加标记,方便后续按标签识别资源 |
spec.containers | 定义 Pod 内要运行的容器 |
image | 使用刚才构建并加载的 course-orders:v1 镜像 |
imagePullPolicy: IfNotPresent | 节点已有该镜像时直接使用;没有时才尝试拉取 |
containerPort: 3000 | 声明应用容器使用 3000 端口,并不代表已对外开放 |
这里的 spec 可以理解为 希望这个 Pod 怎样运行。由于我们已经用 kind 把镜像加载到节点,IfNotPresent 可以让节点优先使用本地镜像。
course Namespace,请先执行 kubectl create namespace course。如果该 Namespace 已存在,就不需要重复创建。🔎 启动、观察和访问
这一节的每条关键命令都包含模拟输出和判断方法。输出中的时间、IP、事件信息可能与实际环境不同。
1. 创建 Pod
在 pod.yaml 所在目录执行:
kubectl apply -f pod.yaml
首次创建成功时,模拟输出:
pod/orders-demo created
这表示 Kubernetes 已接收创建请求,不代表程序此刻已经运行就绪。
2. 查看 Pod 状态
kubectl get pods -n course -o wide
等待 Pod 启动后,模拟输出:
NAME READY STATUS RESTARTS AGE IP NODE
orders-demo 1/1 Running 0 35s 10.244.0.5 node-course-control-plane
这里的 -n course 表示只查看 course Namespace;-o wide 表示显示更多列。
| 字段 | 含义 |
|---|---|
READY | 已就绪容器数 / 容器总数;1/1 表示唯一的容器已经就绪 |
STATUS | 当前展示的 Pod 状态,例如 Pending、Running |
RESTARTS | 容器重启次数 |
IP | 集群内分配给 Pod 的 IP,不是电脑的公开访问地址 |
NODE | Pod 运行在哪个 Node 上 |
刚创建时,可能先看到 Pending 或 ContainerCreating,稍后才变成 Running。本例未设置应用健康检查探针,因此 Running 和 READY 1/1 也不能完全保证业务接口正常;接下来还要实际访问它。
3. 查看 Pod 详细信息
kubectl describe pod orders-demo -n course
模拟输出节选:
Name: orders-demo
Namespace: course
Node: node-course-control-plane/...
Status: Running
Containers:
orders:
Image: course-orders:v1
State: Running
Ready: True
Events:
Type Reason Message
---- ------ -------
Normal Scheduled Successfully assigned course/orders-demo to node-course-control-plane
Normal Started Started container orders
describe 可以查看 Pod 所在节点、容器使用的镜像、运行状态和近期事件(Events)。排查启动失败时,尤其要注意 State 和 Events。事件内容随环境变化,不一定和示例完全一致。
4. 查看 Node.js 程序日志
kubectl logs orders-demo -n course
根据前面的 server.js,模拟输出:
> course-orders@1.0.0 start
> node server.js
订单服务已启动,监听端口 3000
这说明容器运行了 npm start,并输出了 Node.js 程序的启动日志。
5. 从电脑访问 Pod 内的服务
此时 Pod 已在 Kubernetes 集群内运行,但 containerPort: 3000 不会自动把服务暴露到电脑上。为了临时访问它,我们使用 kubectl port-forward。
正在加载流程图…
在 终端 A 执行并保持运行:
kubectl port-forward -n course pod/orders-demo 3000:3000
模拟输出:
Forwarding from 127.0.0.1:3000 -> 3000
Forwarding from [::1]:3000 -> 3000
这表示电脑本地的 3000 端口已转发到 Pod 的 3000 端口。命令会持续运行,不要立即关闭终端 A。
在 终端 B 执行:
curl http://127.0.0.1:3000/api/info
根据本文的 server.js,模拟返回:
{"service":"orders","version":"v1"}
也可以验证健康接口:
curl http://127.0.0.1:3000/healthz
模拟返回:
{"status":"ok"}
现在你已经验证:请求从本机进入端口转发,再到达 Pod 内的 Express 服务,并获得响应。完成后回到终端 A,按 Ctrl+C 停止端口转发。
3000 端口已被占用,可把命令改为 kubectl port-forward -n course pod/orders-demo 3001:3000,随后访问 http://127.0.0.1:3001/api/info。左边是电脑端口,右边是 Pod 内端口。⚠️ 为什么不直接用 Pod 部署正式业务
现在我们创建的是一个 裸 Pod:它不是由 Deployment 这样的工作负载控制器管理的。
执行删除:
kubectl delete -f pod.yaml
模拟输出:
pod "orders-demo" deleted
再次查看:
kubectl get pods -n course
如果该 Namespace 中没有其他 Pod,模拟输出:
No resources found in course namespace.
为什么 Pod 没有自己重新出现?因为我们只创建了一个 Pod,没有创建负责维持 Pod 副本数量的控制器。
注意,不要把“容器进程异常退出后可能被重启”和“Pod 资源被删除后自动重新创建”混为一谈。
正式业务通常使用下一篇要学习的 Deployment 来管理 Pod 副本与版本更新。本篇先理解裸 Pod 的创建、运行和删除,不提前展开 Deployment 配置。
❓ 知识问答
Q:Pod 与容器是一回事吗?
不是。Pod 是 Kubernetes 调度应用的基本单位,一个 Pod 可以包含一个或多个容器。容器负责真正运行 Node.js 程序。
Q:为什么 Docker 镜像构建成功后,还需要执行 kind load docker-image?
因为本例的 kind 节点有自己的镜像存储。先加载镜像,Pod 才能在节点上直接使用 course-orders:v1,而不必从外部仓库获取。
Q:删除一个裸 Pod,它会自动重新创建吗?
不会。裸 Pod 没有副本控制器负责补齐。下一篇的 Deployment 会解决这类应用管理问题。
🧪 小练习
尝试模拟一次 镜像名称错误导致 Pod 无法启动 的情况:
- 确认已通过前面的命令删除
orders-demoPod。 - 把
pod.yaml中的镜像名称从course-orders:v1临时改为course-orders:missing-demo。 - 执行
kubectl apply -f pod.yaml,再执行kubectl get pods -n course。 - 运行
kubectl describe pod orders-demo -n course,找到Events中有关拉取镜像失败的信息。 - 删除错误 Pod:
kubectl delete -f pod.yaml;把镜像名称改回course-orders:v1,重新执行kubectl apply -f pod.yaml。
镜像错误时,状态可能先显示为 ErrImagePull,多次重试后显示为 ImagePullBackOff。describe 中可能看到类似信息(模拟节选):
Warning Failed Failed to pull image "course-orders:missing-demo"
Normal BackOff Back-off pulling image "course-orders:missing-demo"
验收标准: 能解释为什么节点找不到镜像、能通过 Events 定位问题,并在恢复正确镜像后看到 Pod 运行。如果实际执行过练习,请保留最后恢复的 Pod,方便下一篇继续观察。
🎉 恭喜你!你已经理解了 Pod 与 Node、容器的关系,并完成了 Node.js 镜像构建、Pod 创建、状态检查、日志查看和端口访问。下一篇我们会学习如何用 Deployment 管理这些 Pod,而不再依赖手动创建裸 Pod。
