容器与云原生 / 系统课时
初始化容器
初始化容器
Init Container 适合把“应用启动前必须完成”的工作从主容器中拆出来。本节用一个 Pod 演示两个初始化容器按顺序准备配置和数据,再由应用容器读取结果,并说明失败重试与幂等边界。
学习目标
- 理解 Init Container 在 Pod 启动流程中的顺序执行规则
- 用 Init Container 完成依赖检查、配置准备或数据初始化
- 通过 Pod 状态和应用日志验证初始化结果
Init Container 解决什么问题
Init Container 与普通容器写在同一个 Pod 中,但位于 spec.initContainers。kubelet 会按清单顺序启动它们:前一个必须成功退出,后一个才会启动;所有初始化容器成功后,应用容器才进入启动阶段。
典型用途包括等待外部依赖可用、生成运行时配置、从受控位置准备启动数据。它们可以使用与主容器不同的镜像和工具,并通过 emptyDir 等共享卷把结果交给应用容器。

构造顺序初始化 Pod
下面的 Pod 有两个初始化步骤。第一个写入配置,第二个只有在配置文件存在时才写入数据;主容器启动后同时读取两个文件。
apiVersion: v1
kind: Pod
metadata:
name: init-demo
spec:
initContainers:
- name: prepare-config
image: busybox:1.36
command: ['sh', '-c']
args:
- |
echo 'MODE=production' > /work/config/app.env
volumeMounts:
- name: config
mountPath: /work/config
- name: prepare-data
image: busybox:1.36
command: ['sh', '-c']
args:
- |
test -s /work/config/app.env
echo 'seed=ready' > /work/data/seed.txt
volumeMounts:
- name: config
mountPath: /work/config
- name: data
mountPath: /work/data
containers:
- name: app
image: busybox:1.36
command: ['sh', '-c']
args:
- |
cat /work/config/app.env
cat /work/data/seed.txt
sleep 3600
volumeMounts:
- name: config
mountPath: /work/config
- name: data
mountPath: /work/data
volumes:
- name: config
emptyDir: {}
- name: data
emptyDir: {}
restartPolicy: Always这份配置生效后,应用容器不会与两个 Init Container 并行启动。prepare-data 对配置文件的检查同时充当顺序门禁;如果前一步没有留下有效文件,它会失败,应用也不会启动。
应用并验证初始化结果
将清单保存为 init-demo.yaml,在可用的 Kubernetes 集群中执行:
kubectl apply -f init-demo.yaml
kubectl wait --for=condition=Ready pod/init-demo --timeout=120s
kubectl logs init-demo -c app预期输出:
pod/init-demo created
pod/init-demo condition met
MODE=production
seed=ready如果 Pod 已存在,第一行可能显示 configured 或 unchanged;镜像拉取与调度耗时也会因环境不同。关键验收点是 Pod 最终 Ready,且应用日志能同时读到两个初始化步骤准备的内容。
失败重试与设计边界
某个 Init Container 以非零状态退出时,后续初始化容器和应用容器都不会继续。对 restartPolicy 为 Always 或 OnFailure 的 Pod,kubelet 会重试失败的初始化步骤;Never 则会让 Pod 进入失败状态。
初始化逻辑应尽量具备幂等性,例如重复生成同一份配置不会产生冲突,重复下载不会留下半成品。不要把持续运行的代理或长期守护进程放进普通 Init Container,因为它必须结束后,Pod 才能继续进入应用启动阶段。