Kubernetes - 如何利用 K8S 拉取私有仓库镜像

问题描述

最近实战时，发现一个很奇怪的问题，在通过 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 不需要改动。而第一种需要改动，第三种会导致镜像丢失，毕竟只有本地存在。