K8s 的 command/args 会覆盖 Dockerfile 的 CMD/ENTRYPOINT

Dockerfile 里已经有 python3 quota.py 启动命令，为什么 Deployment 里不写 exec python3 quota.py，Pod 就启动失败？这本质是 K8s 的 command/args 会覆盖 Dockerfile 的 CMD/ENTRYPOINT ，且 args 脚本的执行逻辑决定了容器是否能长期运行------我会拆解清楚背后的原理和 args 的特殊规则。

一、核心原因：K8s command/args 覆盖了 Dockerfile 的启动命令

1. Dockerfile 与 K8s command/args 的优先级规则

Docker 镜像的启动命令由 ENTRYPOINT + CMD 组成，但 K8s 中：

• 如果 Deployment 定义了 command → 直接覆盖 Dockerfile 的 ENTRYPOINT；
• 如果 Deployment 定义了 args → 覆盖 Dockerfile 的 CMD（作为 ENTRYPOINT 的参数）；
• 你当前的配置：command: ["/bin/sh", "-c"] + args: [你的脚本] → 完全替换了 Dockerfile 里的所有启动命令。

举个例子：

假设你的 Dockerfile 是：

ENTRYPOINT ["python3"]
CMD ["quota.py"]

正常运行镜像时，执行的是 python3 quota.py；但你的 Deployment 配置了：

command: ["/bin/sh", "-c"]
args: ["你的脚本（不含exec python3 quota.py）"]

→ K8s 会忽略 Dockerfile 的 ENTRYPOINT/CMD，只执行 /bin/sh -c 你的脚本 ------ 而你的脚本只做了"等配置文件→读配置→导出环境变量→打印env"，执行完就退出，容器自然会重启。

2. 为什么加 exec python3 quota.py 就正常？

• 不加这句：脚本执行完所有步骤后，/bin/sh 进程退出（退出码0），容器无长期运行的进程，触发 CrashLoopBackOff；
• 加了 exec python3 quota.py：exec 会用 python3 quota.py 进程替换当前的 sh 进程，Python 脚本是长期运行的（比如循环检查 S3 配额），容器有了持续的主进程，就能稳定运行。

二、args 脚本的两个关键特殊规则（你必须知道）

1. args 是 command 的参数，且脚本执行完就结束

你的配置中：

command: ["/bin/sh", "-c"]  # 启动shell，执行后续字符串
args: ["你的多行脚本"]       # 这是传给 `sh -c` 的参数

• sh -c "脚本内容" 的执行逻辑：逐行运行脚本里的命令，所有命令执行完后，shell 进程就会退出；
• 只有脚本最后启动一个"长期运行的进程"（比如你的 Python 脚本），容器才不会退出；
• 哪怕 Dockerfile 里有启动命令，也会被 command/args 覆盖，完全不生效。

2. exec 的特殊作用（关键！）

你写的 exec python3 quota.py 中，exec 不是 Python 的命令，而是 shell 的内置命令：

• 不加 exec：python3 quota.py 会作为 sh 进程的子进程运行 → 即使 Python 脚本在运行，sh 进程仍会等待脚本结束，若脚本是后台运行（比如加 &），sh 进程会直接退出；
• 加 exec：python3 quota.py 会替换当前的 sh 进程 → 容器的主进程变成 Python 进程，只要 Python 脚本不退出，容器就不会退出（这是 K8s 容器稳定运行的核心要求）。

三、验证：对比两种场景的进程树

场景	容器内的主进程	结果
args 不含 exec python3 quota.py	sh 进程执行完脚本后退出	容器主进程消失，K8s 重启容器（CrashLoopBackOff）
args 含 exec python3 quota.py	sh 进程被替换为 python3 quota.py	Python 进程成为主进程，长期运行，容器稳定
无 K8s command/args（用Dockerfile命令）	python3 quota.py 是主进程	容器正常运行

四、优化方案（两种可选，推荐第二种）

方案1：保留 K8s command/args，精简脚本

既然 command/args 覆盖了 Dockerfile，就把脚本写完整，且保留 exec：

args:
  - >
    # 加超时，避免无限循环
    MAX_WAIT=30
    COUNT=0
    while [ ! -f /root/.config/rclone/$rcloneconfig ] && [ $COUNT -lt $MAX_WAIT ]; do
      sleep 1
      COUNT=$((COUNT+1))
    done
    if [ ! -f /root/.config/rclone/$rcloneconfig ]; then
      echo "ERROR: config file not found"
      exit 1
    fi
    # 读取配置并导出环境变量（不变）
    CONFIG_FILE="/root/.config/rclone/$rcloneconfig"
    ACCESS_KEY_ID=$(grep 'access_key_id' $CONFIG_FILE | cut -d'=' -f2 | tr -d ' ')
    SECRET_ACCESS_KEY=$(grep 'secret_access_key' $CONFIG_FILE | cut -d'=' -f2 | tr -d ' ')
    ENDPOINT=$(grep 'endpoint' $CONFIG_FILE | cut -d'=' -f2 | tr -d ' ')
    export S3_ACCESS_KEY=$ACCESS_KEY_ID
    export S3_SECRET_KEY=$SECRET_ACCESS_KEY
    export S3_ENDPOINT_URL=$ENDPOINT
    export S3_ACCOUNT_NAME=fawwsweecloud
    export CHECK_INTERVAL=30
    # 用exec启动Python脚本（核心）
    exec python3 quota.py

方案2：复用 Dockerfile 命令，简化 K8s 配置（推荐）

既然 Dockerfile 已有 python3 quota.py，可以让 K8s 只传"前置脚本"，不覆盖核心启动命令：

# 删掉 command，只保留 args（作为 Dockerfile ENTRYPOINT 的参数）
# 前提：Dockerfile 的 ENTRYPOINT 是 ["/bin/sh", "-c"]，或 ENTRYPOINT ["python3"] + CMD ["quota.py"]
command: []  # 清空command，使用Dockerfile的ENTRYPOINT
args:
  - >
    # 前置脚本：等配置文件+导出环境变量
    MAX_WAIT=30
    COUNT=0
    while [ ! -f /root/.config/rclone/$rcloneconfig ] && [ $COUNT -lt $MAX_WAIT ]; do
      sleep 1
      COUNT=$((COUNT+1))
    done
    if [ ! -f /root/.config/rclone/$rcloneconfig ]; then
      echo "ERROR: config file not found"
      exit 1
    fi
    CONFIG_FILE="/root/.config/rclone/$rcloneconfig"
    ACCESS_KEY_ID=$(grep 'access_key_id' $CONFIG_FILE | cut -d'=' -f2 | tr -d ' ')
    SECRET_ACCESS_KEY=$(grep 'secret_access_key' $CONFIG_FILE | cut -d'=' -f2 | tr -d ' ')
    ENDPOINT=$(grep 'endpoint' $CONFIG_FILE | cut -d'=' -f2 | tr -d ' ')
    export S3_ACCESS_KEY=$ACCESS_KEY_ID
    export S3_SECRET_KEY=$SECRET_ACCESS_KEY
    export S3_ENDPOINT_URL=$ENDPOINT
    export S3_ACCOUNT_NAME=fawwsweecloud
    export CHECK_INTERVAL=30
    # 执行Dockerfile的原始命令
    python3 quota.py

总结

1. 核心规则 ：K8s command/args 会覆盖 Dockerfile 的 ENTRYPOINT/CMD，你的脚本替代了镜像原本的启动命令；
2. args 特殊点 ：args 是传给 command 的脚本，执行完就退出，必须启动长期进程；
3. exec 的作用：替换 shell 进程为 Python 进程，让 Python 成为容器主进程；
4. 关键结论 ：不是 args 有"特殊说明"，而是 K8s 容器必须有一个长期运行的主进程------不加 exec python3 quota.py，脚本执行完就退出，容器自然启动失败。