Pod

理解 Pod 与容器的关系,并动手构建镜像、创建、查看、访问和删除一个 Node.js 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.namePod 的名称是 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,不是电脑的公开访问地址
NODEPod 运行在哪个 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 无法启动 的情况:

  1. 确认已通过前面的命令删除 orders-demo Pod。
  2. 把 pod.yaml 中的镜像名称从 course-orders:v1 临时改为 course-orders:missing-demo。
  3. 执行 kubectl apply -f pod.yaml,再执行 kubectl get pods -n course。
  4. 运行 kubectl describe pod orders-demo -n course,找到 Events 中有关拉取镜像失败的信息。
  5. 删除错误 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。