容器与云原生 / 系统课时

容器命令与启动参数

容器命令与启动参数

本课解决“镜像已经构建好,但启动行为需要在不同环境中调整”的问题。你将学会用 command 和 args 覆盖镜像默认入口与参数,并通过日志确认容器实际执行的命令。

学习目标

  • 说明 command、args 与镜像 ENTRYPOINT、CMD 的对应关系
  • 编写可运行的 Pod 清单,自定义容器启动命令和参数
  • 判断 Shell 写法、信号处理和参数覆盖中的常见错误

command 与 args 的本质

Kubernetes 不会重新构建镜像,而是在创建容器时决定最终进程参数。Pod 清单中的 command 对应镜像的 ENTRYPOINT,args 对应镜像的 CMD。二者都是字符串数组,组合后构成容器主进程的参数列表。

Pod 配置 最终行为
均未设置 使用镜像的 ENTRYPOINT 和 CMD
只设置 args 保留镜像入口,替换默认参数
只设置 command 替换镜像入口,继续使用镜像默认参数
两者都设置 完全使用 Pod 中声明的命令与参数

这类覆盖只对当前 Pod 模板生效,不会修改镜像本身。Deployment 更新模板后,新建 Pod 使用新配置,已经运行的旧 Pod 不会在原地改变启动命令。

主示例:显式执行启动脚本

下面创建一个一次性 Pod。command 指定 Shell 与 -c,args 中的整段文本交给 Shell 解释,因此可以顺序执行多条命令。

yaml
apiVersion: v1
kind: Pod
metadata:
  name: command-demo
spec:
  restartPolicy: Never
  containers:
    - name: demo
      image: busybox:1.36
      command: ["/bin/sh", "-c"]
      args:
        - |
          echo "mode=lesson"
          echo "worker-count=3"
          sleep 2

将清单保存为 command-demo.yaml,再创建 Pod 并读取日志。

bash
kubectl apply -f command-demo.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Succeeded pod/command-demo --timeout=60s
kubectl logs command-demo

预期输出:

text
pod/command-demo created
pod/command-demo condition met
mode=lesson
worker-count=3

kubectl wait 的等待时长可能因镜像拉取速度不同而变化。Pod 最终进入 Succeeded,是因为主进程执行完毕且 restartPolicy 为 Never。

选择直接执行还是 Shell 执行

只启动一个程序时,优先把可执行文件和参数分别放入数组,例如 command: ["/app/server"] 与 args: ["--port", "8080"]。这样不会额外引入 Shell,参数边界清晰,容器主进程也能直接接收终止信号。

需要管道、重定向、变量展开或连续命令时,才显式使用 /bin/sh -c。若直接写 command: ["echo hello && sleep 10"],Kubernetes 会把整段内容当作可执行文件名,而不会自动解析 &&。

Tips:command 和 args 在容器启动后不能修改。变更工作负载模板会创建新 Pod,而不是改变现有进程。

验证与典型排错

容器反复重启或立即失败时,先查看 Pod 状态和事件,再检查终止原因。常见问题包括可执行文件路径不存在、镜像中没有 /bin/sh、参数顺序错误,以及脚本返回非零退出码。

对于长时间运行的服务,不要只用 Shell 启动后台进程后立即退出。容器生命周期取决于主进程;主进程结束后,即使后台子进程曾启动,容器也会终止。需要包装脚本时,应在脚本末尾用 exec 替换 Shell,使应用进程成为 PID 1 并正确接收信号。

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

目录与阅读设置

阅读设置

17

记录一个想法

容器命令与启动参数

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

登录哪都通