Jupyter Docker镜像本地运行正常 但Kubernetes部署出现CrashLoopBackOff错误

问题根因 #

1. 你的Dockerfile中Jupyter启动命令没有显式指定端口参数，仅依赖Jupyter默认的8888端口配置。而Kubernetes运行时会为容器自动注入大量Service相关的环境变量，和Jupyter的配置读取逻辑产生冲突，导致Jupyter无法正常获取端口配置，抛出KeyError: 'port'错误。
2. 额外说明：你Dockerfile中开头的FROM ubuntu:latest是多余的，多阶段构建并没有用到这个阶段的产物，可以直接删除。

修复方案 #

1. 优先方案：修改Dockerfile的启动命令，显式指定端口 #

更新你的Dockerfile的CMD行，加上--port=8888参数：

# 删掉多余的 FROM ubuntu:latest 行
FROM python:3.7

WORKDIR /app
ADD . /app

RUN pip install -r requirements.txt

# 显式指定端口参数，避免环境变量冲突
CMD ["jupyter", "notebook", "--allow-root", "--ip=0.0.0.0", "--port=8888"]

修改后重新构建镜像即可，如果你使用的是minikube集群，需要把新构建的镜像加载到minikube的镜像仓库中，再重新部署。

2. 临时方案：直接在Deployment的容器配置中覆盖启动命令 #

如果不想重新构建镜像，可以直接修改deployment.yaml的容器配置，添加command和args参数：

containers:
- name: hello-jupyter
  image: hello-jupyter
  imagePullPolicy: Never
  ports:
  - containerPort: 8888
  # 覆盖镜像默认启动命令，显式指定端口
  command: ["jupyter"]
  args: ["notebook", "--allow-root", "--ip=0.0.0.0", "--port=8888"]

其他注意事项 #

• Jupyter默认启动会生成随机登录token，如果你不需要token验证，可以在启动参数中添加--NotebookApp.token='' --NotebookApp.password=''，方便直接访问。
• 你设置了replicas=4，4个Jupyter实例是完全独立的，存储互不共享，如果你需要持久化存储笔记，需要额外配置PV/PVC挂载/app目录。
• 如果你用的是minikube环境，LoadBalancer类型的Service需要执行minikube tunnel才能对外暴露访问。

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