容器与云原生 / 系统课时
多容器 Pod
多容器 Pod
本课解决“多个容器何时应该放进同一个 Pod,以及它们如何协作”的问题。你将创建一个由 Nginx 主容器和日志 Sidecar 组成的 Pod,验证它们共享网络与卷,并掌握多容器设计的边界。
学习目标
- 说明同一 Pod 内容器共享网络和存储的方式。
- 使用
emptyDir让主容器与 Sidecar 交换数据。 - 判断日志采集、代理和配置同步等 Sidecar 场景是否适合放入同一 Pod。
多容器 Pod 的协作本质
Pod 是 Kubernetes 调度和生命周期管理的最小单位。同一 Pod 内的容器会被调度到同一节点,并共享一个网络命名空间,因此它们拥有相同的 Pod IP,可以通过 127.0.0.1 和不同端口互相访问。容器文件系统仍彼此隔离,只有显式挂载同一个 Volume,才能共享文件。

Sidecar 不是独立业务服务,而是围绕主容器提供辅助能力的长期运行容器。主容器和 Sidecar 通常一起创建、一起迁移,也共享故障影响范围。只有当两个进程需要紧密协作、必须同机运行并共享生命周期时,才应组合成多容器 Pod。
创建日志 Sidecar 示例
下面的 Pod 将 Nginx 日志目录挂载到 emptyDir。Nginx 把访问日志写入共享卷,Sidecar 持续跟踪同一文件,并通过自己的标准输出暴露日志。
apiVersion: v1
kind: Pod
metadata:
name: multi-container-demo
spec:
containers:
- name: web
image: nginx:1.27-alpine
ports:
- name: http
containerPort: 80
volumeMounts:
- name: nginx-logs
mountPath: /var/log/nginx
- name: log-sidecar
image: busybox:1.36
command:
- sh
- -c
- |
touch /var/log/nginx/access.log
tail -n+1 -F /var/log/nginx/access.log
volumeMounts:
- name: nginx-logs
mountPath: /var/log/nginx
volumes:
- name: nginx-logs
emptyDir: {}emptyDir 在 Pod 创建时建立,在 Pod 内所有容器之间共享;Pod 被删除后,其中的数据也会删除。该配置不会保证两个普通容器的启动先后顺序,因此 Sidecar 先执行 touch,避免日志文件尚未创建时直接退出。
部署并验证共享关系
将配置保存为 multi-container-pod.yaml,然后创建 Pod,等待两个容器都进入 Ready 状态。
kubectl apply -f multi-container-pod.yaml
kubectl wait --for=condition=Ready pod/multi-container-demo --timeout=90s
kubectl get pod multi-container-demo预期输出
pod/multi-container-demo created
pod/multi-container-demo condition met
NAME READY STATUS RESTARTS AGE
multi-container-demo 2/2 Running 0 <TIME>接着在 Sidecar 容器中向 127.0.0.1 发起请求。由于两个容器共享网络,该请求会到达 Nginx;Nginx 写出的访问日志随后会被 Sidecar 读取。
kubectl exec multi-container-demo -c log-sidecar -- wget -qO- http://127.0.0.1/ > /dev/null
kubectl logs multi-container-demo -c log-sidecar --tail=1预期输出
127.0.0.1 - - [<TIME>] "GET / HTTP/1.1" 200 615 "-" "Wget" "-"时间、响应字节数和客户端字符串可能随镜像版本不同而变化,但日志中应出现 GET / 与状态码 200。完成练习后可执行 kubectl delete pod multi-container-demo 清理资源。
设计边界与常见错误
同一 Pod 内的容器不能分别调度,也不能独立扩缩容。若两个服务需要不同副本数、独立发布或独立故障恢复,应拆成不同 Pod,并通过 Service 通信。Sidecar 还会占用 Pod 的 CPU、内存和启动时间,资源请求与限制必须按所有容器合计计算。
不要把“共享 Pod”误认为“自动共享文件”。未挂载共同 Volume 时,两个容器看到的是各自镜像文件系统。还要注意长期运行的 Sidecar 会影响批处理 Pod 的退出条件;对于 Job,应明确设计辅助容器何时终止,避免主任务完成后 Pod 仍停留在 Running 状态。