文章目录
- [Kubernetes Pod 深度详解:K8s 最小调度单元](#Kubernetes Pod 深度详解:K8s 最小调度单元)
-
- [一、什么是 Pod](#一、什么是 Pod)
- [二、Pod 基础管理实操](#二、Pod 基础管理实操)
-
- [2.1 创建 Pod](#2.1 创建 Pod)
- [2.2 查看 Pod 详情、日志](#2.2 查看 Pod 详情、日志)
- [2.3 编辑 Pod](#2.3 编辑 Pod)
- [2.4 在 Pod 内部执行命令](#2.4 在 Pod 内部执行命令)
- [2.5 文件拷贝:宿主机 ↔ Pod](#2.5 文件拷贝:宿主机 ↔ Pod)
- [2.6 删除 Pod](#2.6 删除 Pod)
- [2.7 使用 yaml 清单创建 Pod](#2.7 使用 yaml 清单创建 Pod)
- [综合实验:分开两个 Pod 部署 Wordpress](#综合实验:分开两个 Pod 部署 Wordpress)
- [三、多容器 Pod 实验](#三、多容器 Pod 实验)
- [四、Pod 核心 yaml 属性详解](#四、Pod 核心 yaml 属性详解)
-
- [metadata 元数据](#metadata 元数据)
- [spec Pod 期望规格](#spec Pod 期望规格)
-
- [spec.containers 容器配置](#spec.containers 容器配置)
-
- [ImagePullPolicy 镜像拉取策略](#ImagePullPolicy 镜像拉取策略)
- [restartPolicy Pod 重启策略](#restartPolicy Pod 重启策略)
- [五、Pod 生命周期与常见状态](#五、Pod 生命周期与常见状态)
-
- [Pod 常见 STATUS 状态](#Pod 常见 STATUS 状态)
- [实验 1:单容器 Pod 状态观测](#实验 1:单容器 Pod 状态观测)
- [实验 2:多容器 Pod 状态](#实验 2:多容器 Pod 状态)
- [六、Init Containers 初始化容器](#六、Init Containers 初始化容器)
- [七、静态 Pod static Pod](#七、静态 Pod static Pod)
- 八、面试重点问题梳理
-
- [Q1:Pod 和容器的区别?](#Q1:Pod 和容器的区别?)
- [Q2:为什么 K8s 不直接管理容器,要引入 Pod?](#Q2:为什么 K8s 不直接管理容器,要引入 Pod?)
- Q3:pause(infra)容器的作用?
- 九、环境清理
Kubernetes Pod 深度详解:K8s 最小调度单元
本文基于 Kubernetes v1.30,完整讲解 Pod 核心概念、单 / 多容器 Pod、yaml 属性、生命周期、重启策略、Init 容器、静态 Pod,附带全套可执行实验代码与原理剖析。Pod 是 Kubernetes 最重要的基础对象,理解 Pod 是学习 Deployment、Service 等资源的前提。
一、什么是 Pod
Pod 是 Kubernetes 中应用部署单元 ,官方定义:a single instance of an application in Kubernetes。
Pod 可以理解为豌豆荚:
- Pod(豌豆荚):封装环境,提供统一网络、存储命名空间
- 容器(豌豆) :真正执行业务进程,一个 Pod 可以封装1 个或者多个容器


✅ Pod 核心特性:
- 同一个 Pod 内部所有容器共享网络命名空间 :拥有同一个 Pod IP,容器之间通过
localhost互相通信,端口不能冲突。 - 同一个 Pod 内部所有容器共享 Volume 存储卷,所有容器可以读写同一份存储。
- Pod 内全部容器一定会调度到同一台 Node 节点运行。
- K8s 直接管理 Pod,不直接管理底层容器。
- 每个 Pod 会自动启动 pause(infra)基础容器,用来持有命名空间。
两种 Pod 使用场景
- 单容器 Pod:最常用,一个 Pod 里面只跑一个业务容器,Pod 作为容器的包装外壳。
- 多容器 Pod:多个容器紧密协作。例如 web 容器提供静态文件,sidecar 容器同步更新文件;日志采集容器和业务容器。
二、Pod 基础管理实操
2.1 创建 Pod
kubectl run快速创建 Pod。 --dry-run=client只输出 yaml,不会真正创建资源,写 yaml 非常实用。
# 仅输出yaml,不创建Pod
kubectl run web --image=hub.laoma.cloud/library/nginx --dry-run=client -o yaml
输出结果:
apiVersion: v1
kind: Pod
metadata:
creationTimestamp: null
labels:
run: web
name: web
spec:
containers:
- image: hub.laoma.cloud/library/nginx
name: web
resources: {}
dnsPolicy: ClusterFirst
restartPolicy: Always
status: {}
直接创建运行 Pod:
kubectl run web --image=hub.laoma.cloud/library/nginx
查看 Pod 状态:
# 基础查看pod
kubectl get pod
# -o wide 输出更多信息:PodIP、所在节点
kubectl get pod -o wide
状态说明:
ContainerCreating:镜像拉取、容器启动中Running:Pod 正常运行
排查节点上真实容器,可以登录对应 worker 节点,使用 nerdctl/docker 查看容器列表。
ssh root@worker31 nerdctl ps --namespace k8s.io |grep web
ssh root@worker31 nerdctl images --namespace k8s.io |grep nginx
2.2 查看 Pod 详情、日志
# yaml格式输出Pod完整定义
kubectl get pod web -o yaml
# describe查看Pod详细信息,重点看末尾Events事件,排错神器
kubectl describe pod web
# 查看容器标准输出日志,-f实时跟踪日志流
kubectl logs -f web
2.3 编辑 Pod
kubectl edit pod web
⚠️ 限制:Pod 很多字段不支持在线修改,例如 Pod 名称。遇到不能修改的字段,需要删除 Pod,修改 yaml 后重新 apply 创建。
2.4 在 Pod 内部执行命令
kubectl exec进入 Pod 执行指令。如果 Pod 内有多个容器,需要加-c 指定容器名。
# 在pod执行hostname
kubectl exec web -- hostname
# 执行pwd
kubectl exec web -- pwd
# 执行shell命令写入文件
kubectl exec -it web -- bash -c 'echo Hello World > htdocs/index.html'
# 查看运行用户
kubectl exec web -- id
2.5 文件拷贝:宿主机 ↔ Pod
# 将本机/etc/hosts复制到Pod内 /new-hosts
kubectl cp /etc/hosts web:/new-hosts
# 验证文件是否拷贝成功
kubectl exec web -- ls /new-hosts
2.6 删除 Pod
kubectl delete pod web
Pod 删除优雅终止时间,默认 30 秒:
kubectl get pod web -o yaml|grep 'terminationGracePeriodSeconds'
# terminationGracePeriodSeconds: 30
Pod 收到删除请求后,会等待 30 秒让应用优雅退出,超过时间强制杀死容器进程。
2.7 使用 yaml 清单创建 Pod
编写web.yaml
# web.yaml
apiVersion: v1
kind: Pod
metadata:
labels:
run: web
name: web
spec:
containers:
- image: hub.laoma.cloud/library/nginx
name: web
创建资源两种写法:
# create:新建资源,资源已存在则报错
kubectl create -f web.yaml
# apply:声明式,存在就更新,不存在就创建(推荐)
kubectl apply -f web.yaml
综合实验:分开两个 Pod 部署 Wordpress
mysql 数据库一个 Pod,wordpress 博客一个 Pod。
# 创建mysql数据库pod,设置root密码环境变量
kubectl run wordpress-db --image=mysql --image-pull-policy IfNotPresent --env MYSQL_ROOT_PASSWORD=123
# 创建wordpress博客pod
kubectl run wordpress-app --image=wordpress --image-pull-policy IfNotPresent
kubectl port-forward端口转发,把集群内部 Pod 端口映射到宿主机,实现外部访问。该终端窗口不能关闭。
kubectl port-forward pod/wordpress-app --address 10.1.8.30 8080:80
查看 Pod IP:
kubectl get pods -o wide | awk '{print $1" "$6}'
连接 mysql,手动创建 wordpress 数据库和账号:
mysql -uroot -p123 -h 10.224.19.5
mysql> create database wordpress;
mysql> create user wordpress identified by '123';
mysql> grant all privileges on wordpress.* to wordpress;
mysql> flush privileges;
mysql> exit
浏览器访问 http://10.1.8.30:8080 完成博客初始化配置。

三、多容器 Pod 实验
同一个 Pod 内部同时运行 mysql + wordpress,它们共享网络,wordpress 直接用
127.0.0.1访问 mysql。 编写pod-blog.yaml
apiVersion: v1
kind: Pod
metadata:
name: bbs
labels:
run: bbs
spec:
containers:
- image: hub.laoma.cloud/library/mysql:latest
imagePullPolicy: IfNotPresent
name: mysql
env:
- name: MYSQL_ROOT_PASSWORD
value: "123"
- name: MYSQL_USER
value: tom
- name: MYSQL_PASSWORD
value: "123"
- name: MYSQL_DATABASE
value: bbs
ports:
- containerPort: 3306
name: mysql
protocol: TCP
- image: hub.laoma.cloud/library/wordpress:latest
imagePullPolicy: IfNotPresent
name: wordpress
env:
- name: WORDPRESS_DB_USER
value: tom
- name: WORDPRESS_DB_PASSWORD
value: "123"
- name: WORDPRESS_DB_NAME
value: bbs
- name: WORDPRESS_DB_HOST
value: 127.0.0.1
ports:
- containerPort: 80
name: wordpress
protocol: TCP
hostPort: 80
创建 pod
kubectl apply -f pod-blog.yaml
查看 pod,2/2 Running代表两个容器全部正常启动
kubectl get pods -o wide
多容器 Pod 操作,使用-c指定容器名称:
# 在wordpress容器执行hostname
kubectl exec bbs -c wordpress -- hostname
# 拷贝文件到wordpress容器
kubectl cp /etc/hosts bbs:/new-hosts -c wordpress
kubectl exec bbs -c wordpress -- ls /new-hosts
访问 mysql 数据库验证:
kubectl exec bbs -c mysql -it -- mysql -utom -p123 -e 'show databases;'
访问宿主机 IP http://10.1.8.32打开 wordpress 页面。
注意:多容器 Pod 适合紧密耦合协同,不要把两个独立业务应用放同一个 Pod,独立业务应该拆分成不同 Pod。
四、Pod 核心 yaml 属性详解
查看资源文档命令 kubectl explain pod,可以逐层查看字段说明。
Pod 顶级字段:
kubectl explain pod | grep '^ [a-zA-Z]'
apiVersion <string> # API版本,Pod属于v1
kind <string> # 资源类型 Pod
metadata <ObjectMeta> # 元数据:名字、标签、命名空间
spec <PodSpec> # 期望状态,核心配置
status <PodStatus> # 当前实际状态,只读,不能写yaml
metadata 元数据
kubectl explain pod.metadata | grep '^ [a-zA-Z]'
重点字段:
namePod 名称namespace命名空间labels标签,用于筛选资源annotations注解,存储额外描述信息
spec Pod 期望规格
kubectl explain pod.spec | grep '^ [a-zA-Z]'
重点字段:
containers:必填,Pod 内业务容器列表volumes:定义存储卷,供容器挂载restartPolicy:重启策略imagePullPolicy:镜像拉取策略nodeName:强制调度到指定节点initContainers:初始化容器terminationGracePeriodSeconds:优雅终止超时时间
spec.containers 容器配置
kubectl explain pod.spec.containers | grep '^ [a-zA-Z]'
重点:
name容器名字(必填)image镜像地址command/args覆盖镜像里面默认启动命令env环境变量ports容器端口volumeMounts存储挂载resourcesCPU 内存资源限制livenessProbe/readinessProbe存活 / 就绪探针
ImagePullPolicy 镜像拉取策略
Always:每次都从镜像仓库拉取镜像Never:永远不从仓库拉取,只用本机本地镜像IfNotPresent:本地有镜像就用本地,没有再拉取(日常最常用)
restartPolicy Pod 重启策略
该策略对 Pod 里面全部容器生效:
Always:只要容器退出非 Running 状态,就重启容器,Pod 默认策略OnFailure:只有容器异常退出(返回码非 0)才重启;正常退出不重启Never:无论成功失败,绝不重启容器
示例:
spec:
restartPolicy: Never
containers:
- name: myapp-container
image: hub.laoma.cloud/library/busybox
command: ['sh', '-c', 'echo The app is running! && sleep 5']
五、Pod 生命周期与常见状态
Pod 生命周期取决于内部所有容器的生命周期,容器生命周期等于容器内部进程生命周期。
Pod 常见 STATUS 状态
表格
| 状态 | 含义 |
|---|---|
| ContainerCreating | 正在创建容器,拉取镜像、挂载存储 |
| Running | Pod 所有容器正常运行 |
| Completed | 任务执行完成,全部容器正常退出(退出码 0) |
| Error | 容器运行发生错误 |
| CrashLoopBackOff | 容器反复崩溃,K8s 间隔后退重试启动 |
| ErrImagePull | 镜像拉取失败 |
| ImagePullBackOff | 镜像拉取失败,后退重试拉取 |
| Terminating | Pod 正在删除,优雅终止过程 |
实验 1:单容器 Pod 状态观测
使用kubectl get pod -w实时监控 Pod 状态变化。
正常执行完成 pod:
apiVersion: v1
kind: Pod
metadata:
name: busybox
labels:
app: busybox
spec:
restartPolicy: Never
containers:
- name: busybox
image: hub.laoma.cloud/library/busybox
imagePullPolicy: IfNotPresent
command: ['sh', '-c', 'echo Hello Kubernetes! && sleep 10']
状态流转:ContainerCreating → Running → Completed
错误命令,模拟脚本执行报错:
apiVersion: v1
kind: Pod
metadata:
name: busybox
labels:
app: busybox
spec:
restartPolicy: Never
containers:
- name: busybox
image: hub.laoma.cloud/library/busybox
imagePullPolicy: IfNotPresent
command: ['sh', '-c', 'echoxxx Hello Kubernetes! && sleep 5']
command 和 args 说明:
command: - sh - -c - echo OK! && sleep 10 # 等价写法 args: - sh - -c - echo OK! && sleep 10
实验 2:多容器 Pod 状态
两个容器,一个 sleep5,一个 sleep10
apiVersion: v1
kind: Pod
metadata:
name: busybox
labels:
app: busybox
spec:
restartPolicy: Never
containers:
- name: busybox1
image: hub.laoma.cloud/library/busybox
imagePullPolicy: IfNotPresent
command: ['sh', '-c', 'echo Hello Kubernetes! && sleep 5']
- name: busybox2
image: hub.laoma.cloud/library/busybox
imagePullPolicy: IfNotPresent
command: ['sh', '-c', 'echo Hello Kubernetes! && sleep 10']
状态流转:ContainerCreating → Running → NotReady → Completed
其中一个容器命令错误:
apiVersion: v1
kind: Pod
metadata:
name: busybox
labels:
app: busybox
spec:
restartPolicy: Never
containers:
- name: busybox1
image: hub.laoma.cloud/library/busybox
imagePullPolicy: IfNotPresent
command: ['sh', '-c', 'echoxx Hello Kubernetes! && sleep 5']
- name: busybox2
image: hub.laoma.cloud/library/busybox
imagePullPolicy: IfNotPresent
command: ['sh', '-c', 'echo Hello Kubernetes! && sleep 20']
状态流转:ContainerCreating → Error
✨多容器 Pod 重启策略总结:只要 Pod 内任意一个容器满足重启条件,就会触发 Pod 容器重启。
六、Init Containers 初始化容器
initContainers是 Pod 中特殊初始化容器列表:
- init 容器串行顺序执行 ,必须全部正常退出(exit 0),才会启动业务
containers。 - 如果 init 容器执行失败,会根据
restartPolicy反复重启 Pod,直到 init 全部执行成功。 - init 容器同样可以使用 volumes 存储卷,可以做准备工作。
典型业务场景
- 等待外部 Service、数据库服务就绪
- 下载代码、配置文件到共享卷
- 修改系统配置,预处理环境
示例 1:init 容器创建文件,业务容器读取
apiVersion: v1
kind: Pod
metadata:
name: myapp-pod
labels:
app: myapp
spec:
volumes:
- name: workdir
emptyDir: {}
containers:
- name: myapp-container
image: hub.laoma.cloud/library/busybox
command: ['sh', '-c', 'echo The app is running! && sleep 3600']
volumeMounts:
- name: workdir
mountPath: "/work-dir"
initContainers:
- name: init-poda
image: hub.laoma.cloud/library/busybox
command: ['sh', '-c', 'touch /work-dir/aa.txt && sleep 10']
volumeMounts:
- name: workdir
mountPath: "/work-dir"
Pod 状态变化:Init:0/1 → PodInitializing → Running。
把 init 里面命令改成错误命令,观察现象:
command: ['sh', '-c', 'touchxx /work-dir/aa.txt']
Pod 状态循环:Init:0/1 → Init:Error → Init:CrashLoopBackOff。
示例 2:init 容器等待 service 解析成功
apiVersion: v1
kind: v1
---
apiVersion: v1
kind: Service
metadata:
name: myservice
spec:
ports:
- protocol: TCP
port: 80
targetPort: 9376
---
apiVersion: v1
kind: Service
metadata:
name: mydb
spec:
ports:
- protocol: TCP
port: 80
targetPort: 9377
---
apiVersion: v1
kind: Pod
metadata:
name: myapp-pod
labels:
app: myapp
spec:
initContainers:
- name: init-myservice
image: hub.laoma.cloud/library/busybox
command: ['sh', '-c', 'until nslookup myservice.webapp.svc.cluster.local; do echo waiting for myservice; sleep 2; done;sleep 3;']
- name: init-mydb
image: hub.laoma.cloud/library/busybox
command: ['sh', '-c', 'until nslookup mydb.webapp.svc.cluster.local; do echo waiting for mydb; sleep 2; done;sleep 3;']
containers:
- name: myapp-container
image: hub.laoma.cloud/library/busybox
command: ['sh', '-c', 'echo The app is running! && sleep 3600']
先创建 service 资源,再创建 Pod,init 容器会阻塞直到域名解析成功才启动业务容器。
七、静态 Pod static Pod
集群控制平面组件
kube‑apiserver、kube‑controller‑manager、kube‑scheduler、etcd,这些组件本身就是静态 Pod。
特点:
- 不由 apiserver 管理,由本机 kubelet 直接管理。
- kubelet 持续扫描
staticPodPath目录下 yaml 文件,根据文件自动创建 / 删除 Pod。 - 不能通过 Deployment、控制器管理;不能做健康检查。
查看 kubelet 配置:
# kubelet配置文件,找到staticPodPath
grep staticPodPath /var/lib/kubelet/config.yaml
# staticPodPath: /etc/kubernetes/manifests
# 查看静态pod清单
ls -1 /etc/kubernetes/manifests
etcd.yaml
kube-apiserver.yaml
kube-controller-manager.yaml
kube-scheduler.yaml
只要修改、删除该目录 yaml,kubelet 自动增删静态 Pod。
⚠️ 不要随意修改
staticPodPath路径,否则控制平面组件会无法启动。
八、面试重点问题梳理
Q1:Pod 和容器的区别?
容器:底层运行时概念,真正跑业务进程。 Pod:K8s最小调度单元,是容器的封装外壳。
- Pod 拥有独立 Pod IP;容器没有独立 IP。
- 一个 Pod 内部可以运行多个容器,共享网络 namespace、volume 存储。
- K8s 调度、自愈、扩缩容全部以 Pod 对象为单位,不直接操作容器。

表格
| 特性 | 容器 | Pod |
|---|---|---|
| K8s 最小调度单位 | ❌ | ✅ |
| 独立 IP | ❌ | ✅ |
| 支持多容器协同 | ❌ | ✅ |
| 网络存储共享 | ❌ | ✅ |
| 完整生命周期管理 | ❌ | ✅ |
Q2:为什么 K8s 不直接管理容器,要引入 Pod?
- 多容器协同需求:sidecar 代理、日志采集、init 初始化容器,多个容器必须调度同一台机器,共享网络存储。
- 统一抽象:把网络、存储、重启策略、健康检查全部封装到 Pod,上层控制器只需要操作 Pod。
- 解耦底层 CRI 容器运行时,屏蔽 containerd/docker 差异。
Q3:pause(infra)容器的作用?
每个 Pod 都会自动启动 pause 容器:
- 创建并且持有 Pod 的 Linux Namespace(网络、IPC)。业务容器加入 pause 的命名空间,实现网络共享。
- pause 容器持续运行,持有 Pod 的 IP 和网络环境。业务容器反复重启不会丢失网络。
- 比喻:pause 是房东,先占好房子(网络命名空间),业务容器是租客,租客进出,房子不变。
如果 pause 容器退出,整个 Pod 的网络环境直接销毁。
九、环境清理
kubectl delete ns pods