Django调用Google Kubernetes Client执行容器内程序异常排查

一、先修复最核心的参数错误 #

你在Django代码的args里给path/to/exe加了双引号，这是错误的。K8s容器的args是按数组拆分传递参数的，额外添加的双引号会被当成路径的一部分，导致xvfb-run找不到可执行文件，最终进程卡住。

修正后的代码：

container = client.V1Container(
    name=container_name,
    command=["xvfb-run"],
    args=["-a", "path/to/exe"],  # 去掉多余的双引号
    image=container_image,
    env=env_list,
    security_context=security
)

二、查看控制台输出的方法 #

1. 拉取Pod日志：直接用kubectl获取对应Job生成的Pod日志：

   kubectl logs <pod-id> -c jobcontainer
   

   如果Pod已退出，加--previous查看历史日志：

   kubectl logs <pod-id> -c jobcontainer --previous
   

2. 查看进程的标准输出/错误：进入运行中的容器后，通过proc文件系统查看目标进程的输出：

   # 查看PID为1的进程标准输出
   cat /proc/1/fd/1
   # 查看标准错误
   cat /proc/1/fd/2
   

3. 重定向输出到文件：修改Job配置，将程序输出写入容器内文件，方便后续排查：

   container = client.V1Container(
       name=container_name,
       command=["sh", "-c"],
       args=["xvfb-run -a path/to/exe > /tmp/app.log 2>&1"],
       image=container_image,
       env=env_list,
       security_context=security
   )
   

   之后进入容器查看/tmp/app.log即可。

三、其他排查方向 #

1. 权限问题 #

• 检查可执行文件权限：进入容器后执行ls -l path/to/exe，确保文件有x执行权限，没有的话在Dockerfile中添加RUN chmod +x path/to/exe。
• 检查Pod的安全上下文：如果security_context设置了runAsUser/runAsGroup，要确保该用户能访问可执行文件及GCS认证相关文件。
• GCS访问权限：手动执行时可能继承了本地gcloud的认证，但容器内需要确保有正确的认证方式（如工作负载身份、挂载服务账号密钥），检查env_list是否包含GOOGLE_APPLICATION_CREDENTIALS等必要环境变量。

2. 执行环境差异 #

手动执行是在交互式shell中，而K8s容器默认是非交互式环境，可能缺少部分环境变量导致xvfb-run异常。可以尝试显式调用shell来执行命令：

container = client.V1Container(
    name=container_name,
    command=["bash", "-c"],
    args=["xvfb-run -a path/to/exe"],
    image=container_image,
    env=env_list,
    security_context=security
)

3. 进程状态分析 #

从ps aux的输出看，你的C++程序进程并未出现，说明xvfb-run根本没成功启动它——核心原因就是之前的参数引号错误，导致xvfb-run找不到目标可执行文件，一直在等待或报错。

内容的提问来源于stack exchange，提问作者Turgut