kubernetes Pod无法启动问题排查总结

最新推荐文章于 2025-05-29 16:16:49 发布

原创

最新推荐文章于 2025-05-29 16:16:49 发布 · 1.2w 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#kubernetes

本文总结了在部署Kubernetes服务时遇到Pod无法启动的问题，主要原因是pause镜像拉取失败。分析了可能的故障点，包括镜像问题、网络访问限制等，并提供了通用的解决办法，如手动替换镜像，以及更优雅的配置私有仓库方案。同时介绍了pause镜像在Pod中的作用和重要性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一：问题描述

本周，通过kubernetes搭建企业级jupyterhub服务的时候，遇到个问题:
通过helm部署jupyterhub的时候，hook-image-puller-b8p5p这个pod一直无法启动，反复于 ErrImagePull 和 ImagePullBackOff两个状态，如下

[zhanhaitao@master ~]$ kubectl -n jhub get pods
NAME                       READY   STATUS         RESTARTS   AGE
hook-image-awaiter-qpsw6   1/1     Running        0          68s
hook-image-puller-b8p5p    0/1     ErrImagePull   0          68s

二：系统环境

centos：7.1版本
k8s 版本：1.13.2
helm 版本：v2.13.1

k8s集群是参考官网的用户手册通过kubeadm完成搭建的，一个master，一个node

jupyterhub的配置文件：
[zhanhaitao@master ~]$ cat config.yaml
proxy:
  secretToken: ebcf616d2ae617e67bf8d5c93c4b131abb25adf5849d68a5be51bc922ef072c7
  https:
    enabled: false

部署命令：
[zhanhaitao@master ~]$ helm upgrade --install jhub jupyterhub/jupyterhub \
>   --namespace jhub  \
>   --version=0.8.2 \
>   --values config.yaml

三：问题分析

status=ErrImagePull 和 ImageBackOff，通过字面分析，应该是k8s启动pod时候，拉取镜像失败导致。
ImageBackOff是k8s中一个镜像相关的常见问题，一般导致的原因主要有如下几个：
1.镜像是本公司的私服镜像
2.镜像写法不对或者版本不对
3.镜像所在仓库无法访问，或者访问超时

3.1 确定具体的问题镜像

下面来分析是上面哪个原先导致，在k8s中，大部分的问题，都能通过logs和describe两个命令进行分析和定位

[zhanhaitao@master ~]$ kubectl -n jhub logs hook-image-puller-b8p5p
Error from server (BadRequest): container "pause" in pod "hook-image-puller-b8p5p" is waiting to start: trying and failing to pull