容器与云原生 / 系统课时
容器命令与启动参数
容器命令与启动参数
本课解决“镜像已经构建好,但启动行为需要在不同环境中调整”的问题。你将学会用 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 解释,因此可以顺序执行多条命令。
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 并读取日志。
kubectl apply -f command-demo.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Succeeded pod/command-demo --timeout=60s
kubectl logs command-demo预期输出:
pod/command-demo created
pod/command-demo condition met
mode=lesson
worker-count=3kubectl 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 并正确接收信号。