基于Kubernetes部署Nginx镜像遇容器重启失败问题排查

从你描述的场景和提供的Dockerfile内容来看，最可能的问题是Nginx以守护进程模式启动，导致容器PID 1进程退出，进而触发Kubernetes的重启机制。

核心问题分析 #

你的Dockerfile最后使用了CMD ["nginx"]，但默认情况下nginx命令会让Nginx以后台守护进程的方式运行。容器的生命周期完全绑定到PID 1进程，当Nginx后台运行后，PID 1的nginx进程会直接退出，容器随之停止，Kubernetes会不断尝试重启容器，也就出现了你看到的Back-off restarting failed container错误。

而你手动进入容器后能启动Nginx，是因为此时容器的PID 1是bash交互式进程，不会因为Nginx后台运行而退出，所以容器能保持存活。

解决方案 #

修改Dockerfile中的CMD指令，让Nginx以前台模式运行，确保PID 1进程一直存活：

FROM nginx
COPY ./build/ /usr/share/nginx/html/
RUN rm -f /etc/nginx/conf.d/default.conf
COPY ./default.conf /etc/nginx/conf.d/
# 改用前台运行命令，强制Nginx在前台执行，维持容器生命周期
CMD ["nginx", "-g", "daemon off;"]
EXPOSE 80

额外排查点（如果修改CMD后仍有问题） #

• 验证Nginx配置文件语法：进入容器执行nginx -t，如果配置存在语法错误，根据提示修正default.conf。
• 检查文件权限：确保/usr/share/nginx/html/目录下的静态文件权限正确，Nginx进程能正常读取这些文件。
• 查看Kubernetes容器日志：执行kubectl logs <你的Pod名称>，获取Nginx启动失败的具体错误信息，比如端口冲突、配置路径错误等。

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