如何利用k8s拉取私有仓库镜像

最新推荐文章于 2025-11-15 20:05:38 发布

原创最新推荐文章于 2025-11-15 20:05:38 发布 · 5k 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#docker #java #kubernetes #linux #编程语言

本文介绍了在kubernetes(k8s)中遇到拉取私有仓库镜像时遇到的ImagePullBackOff问题及解决方法。包括修改daemon.json、生成Secret以及使用不同拉取策略。推荐使用通过用户信息生成Secret的方式，因为当密码变更时，只需更新secret即可。

现象

最近实战时，发现一个很奇怪的问题，在通过 k8s 创建 pod，拉取镜像时，总是显示如下信息：

Error syncing pod, skipping: failed to "StartContainer" for "POD" with ImagePullBackOff: "Back-off pulling image ..."

该现象出现的原因可能是网络问题、docker 环境问题等。但如果访问的是一个公开的镜像仓库，在 pull image 的时候，不应该会提示：ImagePullBackOff，但如果访问的是私有仓库，那就有可能出现如下的错误：

这个错误出现的原因，刚才说了，有可能的网络问题，也有可能是 docker 问题，但有时候，这些不能解决的情况下，可以采用下面三种方式来解决。

方式一

第一种方式，我们可以使用文件生成 secret，然后通过 k8s 中的 imagePullSecrets 来解决拉取镜像时的验证问题。具体方式如下：

修改 /etc/docker/daemon.json

在 k8s 集群节点上，修改 docker 的 daemon.json 配置文件:

{
"registry-mirrors": [ "https://registry.docker-cn.com"],
"insecure-registries":["私有仓库服务地址"]
}

在里面加上自己私有的仓库服务地址，然后重启 docker 服务，使其生效。

生成 ~/.docker/config.json 文件

docker login 私有服务地址

在命令行输入上面的命令，回车后，会提示输入用户名和密码。输入正确信息后，这会生成一个 /root/.docker/config.json 文件。同时会提示：

Login Succeeded

生成 Secret 串

根据上面生成的 ~/.docker/config.json 文件，我们可以生成一个密文秘钥：

base64 -w 0 ~/.docker/config.json

执行上面的命令后，会生成一个长串，即为我们所要的 Secret 串。

我们会在 source 下看见一个新的文件夹，_drafts，这个里面会装我们所有的草稿文件。

创建 Secret

通过 k8s 我们可以生成一个 Secret 资源：

apiVersion: v1
kind: Secret
metadata:
  name: docker_reg_secret
  namespace: default
data:
    .dockerconfigjson: ewoJImF1dGhjNWdlpHVnVaenB5Wld4aFFFeFdUa2xCVGtBeU1ERTMiCgkJfASEkidXJlZy5rOHMueXVud2VpLnJlbGEubWUiOiB7CgkJCSJhdXRoIjogIloyRnZaM1Z2WkdWdVSrsaaehoUUV4V1RrbEJUa0F5TURFMyIKCQl9Cgl9LAoJIkh0dHBIZWFkZXJzIjogewoJSetcaFTssZW50IjogIkRvY2tlci1DbGllbnQvMTguMDYuMS1jZSAobGludXgpIgoJfQp9
type: kubernetes.io/dockerconfigjson

执行这个资源的配置：

kubectl create -f secret.yml

在服务配置加上依赖

最后，可以在我们的服务 yml 文件中加上拉取镜像时的依赖 secret，部分代码如下：

imagePullSecrets:
- name: docker_reg_secret

方式二

第二种方式，我们可以直接使用 docker 的用户信息来生成 secret：

kubectl create secret docker-registry docker_reg_secret --docker-server=XXX --docker-username=XXX --docker-password=XXX

参数含义：

docker_reg_secret：指定密钥的键名称，自定义
docker-server：指定docker仓库地址
docker-username：指定docker仓库账号
docker-password：指定docker仓库密码

创建完 Secret 资源后，其他的如方式一，这就简单了。

方式三

第三种方式所使用的是最简单的办法，即我们利用 k8s 的拉取镜像的策略来处理，主要有如下三种：

Always：每次创建时都会拉取镜像
IfNotPresent：宿主机器不存在时拉取镜像（默认值）
Never：从不主动拉取镜像

使用 IfNotPresent、Never 策略来处理。

以上三种方式，我比较推荐第二种，最中意第二种，因为假如密码修改了，就更新一下 secret 就好了，k8s node 不需要改动。而第一种需要改动，第三种会导致镜像丢失，毕竟只有本地存在。

最后，欢迎大家关注个站哟：www.damon8.cn。

最后介绍新号：天山六路折梅手，欢迎关注。

往期回顾

微服务自动化部署CI/CD

ArrayList、LinkedList 你真的了解吗？

基于 Sentinel 作熔断 | 文末赠资料

基础设施服务k8s快速部署之HA篇

今天被问微服务，这几点，让面试官刮目相看

Spring cloud 之多种方式限流（实战）

Spring cloud 之熔断机制（实战）

面试被问finally 和 return，到底谁先执行？

Springcloud Oauth2 HA篇

Spring Cloud Kubernetes之实战一配置管理

Spring Cloud Kubernetes之实战二服务注册与发现

Spring Cloud Kubernetes之实战三网关Gateway

关注公众号，回复入群，获取更多惊喜！公众号(程序猿Damon)里回复 ES、Flink、Java、Kafka、MQ、ML、监控、大数据、k8s 等关键字可以查看更多关键字对应的文章。

如有收获，点个在看，谢谢