容器与云原生 / 系统课时

初始化容器

初始化容器

Init Container 适合把“应用启动前必须完成”的工作从主容器中拆出来。本节用一个 Pod 演示两个初始化容器按顺序准备配置和数据,再由应用容器读取结果,并说明失败重试与幂等边界。

学习目标

  • 理解 Init Container 在 Pod 启动流程中的顺序执行规则
  • 用 Init Container 完成依赖检查、配置准备或数据初始化
  • 通过 Pod 状态和应用日志验证初始化结果

Init Container 解决什么问题

Init Container 与普通容器写在同一个 Pod 中,但位于 spec.initContainers。kubelet 会按清单顺序启动它们:前一个必须成功退出,后一个才会启动;所有初始化容器成功后,应用容器才进入启动阶段。

典型用途包括等待外部依赖可用、生成运行时配置、从受控位置准备启动数据。它们可以使用与主容器不同的镜像和工具,并通过 emptyDir 等共享卷把结果交给应用容器。

Init Container 顺序执行与共享卷

构造顺序初始化 Pod

下面的 Pod 有两个初始化步骤。第一个写入配置,第二个只有在配置文件存在时才写入数据;主容器启动后同时读取两个文件。

yaml
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 集群中执行:

bash
kubectl apply -f init-demo.yaml
kubectl wait --for=condition=Ready pod/init-demo --timeout=120s
kubectl logs init-demo -c app

预期输出:

text
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 才能继续进入应用启动阶段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

初始化容器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通