部署Istio BookInfo示例应用遇ImagePullBackOff错误求助

核心问题 #

从kubectl describe的事件日志可以明确：K8s节点（minikube）无法从Docker Hub拉取docker.io/istio/examples-bookinfo-reviews-v1:1.17.0系列镜像，报错context deadline exceeded属于网络超时/镜像拉取受阻问题，并非需要手动构建镜像（官方文档未提及构建步骤，是因为默认镜像托管在Docker Hub，正常网络环境下可直接拉取）。

解决步骤 #

1. 排查节点网络连通性 #

先验证minikube节点能否正常访问Docker Hub：

# 进入minikube节点
minikube ssh
# 测试Docker Hub连通性
curl -I https://registry-1.docker.io

如果无法访问，可尝试：

• 重启minikube：minikube stop && minikube start --driver=docker（根据你的实际驱动调整参数）
• 给minikube配置代理（若你的环境需代理访问外网）：

  minikube start --docker-env HTTP_PROXY=http://你的代理地址:端口 --docker-env HTTPS_PROXY=http://你的代理地址:端口
  

2. 替换为国内镜像源 #

若Docker Hub访问速度过慢，可修改BookInfo的YAML文件，将镜像地址替换为国内镜像仓库的镜像（比如阿里云镜像）：
打开samples/bookinfo/platform/kube/bookinfo.yaml，找到reviews相关的镜像字段，将docker.io/istio/examples-bookinfo-reviews-v1:1.17.0替换为registry.cn-hangzhou.aliyuncs.com/istio-release/examples-bookinfo-reviews-v1:1.17.0（v2、v3版本做同样替换），然后重新部署：

kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml

3. 手动拉取镜像到本地节点 #

直接在minikube的Docker环境中拉取所需镜像，避免Pod拉取超时：

# 切换到minikube的Docker环境
eval $(minikube docker-env)
# 拉取reviews系列镜像
docker pull docker.io/istio/examples-bookinfo-reviews-v1:1.17.0
docker pull docker.io/istio/examples-bookinfo-reviews-v2:1.17.0
docker pull docker.io/istio/examples-bookinfo-reviews-v3:1.17.0

拉取完成后重新部署Pod，K8s会直接使用本地镜像，无需从远程拉取。

4. 匹配Istio版本 #

注意：BookInfo镜像版本建议与你安装的Istio版本保持一致。从日志看你使用的Istio proxy版本是1.15.3，可尝试将BookInfo镜像的tag改为1.15.3，再重新部署。

总结 #

不需要手动构建Docker镜像并推送到本地仓库，问题根源是镜像拉取的网络问题，按照上述步骤排查即可解决。

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