ホストOS上にDockerイメージを作成し、minikube仮想環境上にPodを作成しようとした際に ErrImageNeverPull が発生した問題の原因と解決方法をまとめました。

環境/再現方法

macOS上にDocker,minikubeをインストール

アプリケーション	バージョン
Docker(Client,Server)	19.03.8
minikube	v1.9.2
kubectl(Client)	v1.18.2
kubectl(Server)	v1.18.2

ホストOS上にイメージを作成

$ docker image build -t test .

イメージ作成結果

docker image ls | grep -B1 test
REPOSITORY                           TAG                 IMAGE ID            CREATED             SIZE
test                                 latest              c73609119b74        55 minutes ago      282MB

利用したマニュフェストファイル

pod.yml

---
apiVersion: v1
kind: Pod
metadata:
  name: testpod
  namespace: default
  labels:
    app: hoge
    env: fuga
spec:
  containers:
  - name: testpod
    image: test
    imagePullPolicy: Never # hostOS上のイメージを取得する

マニュフェストファイルの適用

$ kubectl apply -f pod.yml
pod/testpod created

現象

作成したpodのlog確認

$ kubectl get po
NAME      READY   STATUS              RESTARTS   AGE
testpod   0/1     ErrImageNeverPull   0          2m43s

$ kubectl logs testpod
Error from server (BadRequest): container "test" in pod "testpod" is waiting to start: ErrImageNeverPull

イメージの取得に失敗している。

原因

ホストOS上にDockerイメージ作成したがマニュフェストファイルからはminikubeにて作成された仮想環境上に存在するDockerイメージを取得しようとしたためImagePullエラーが発生。

期待される状態

local上のDockerイメージからPodを作成する。

解決方法

作成失敗したPodを削除

$ kubectl delete -f pod.yml

DockerHub上にlocalにて作成したイメージファイルをPush

$ docker login
$ docker push <user名>/<image名>:<tag名>

マニュフェストファイル内のimagePullPolicyをAlwaysかIfNotPresentに修正

imagePullPolicyの各設定値の挙動は以下の通り

imagePullPolicy: Never
localからイメージを取得

imagePullPolicy: Always
Pod作成時常時イメージをPull

imagePullPolicy: IfNotPresent　
ローカルでイメージが見つからない場合にのみイメージをPull

再度マニュフェストファイルを適用

$ kubectl apply -f pod.yml
pod/testpod created
$ kubectl get po
NAME      READY   STATUS    RESTARTS   AGE
testpod   1/1     Running   0          22s

STATUSがRunningとなり正常にPodが作成できました。
やや強引ではありますが擬似的にlocal上のイメージファイルから作成したPodと同等のPodをminikube上に作成することができました。

追記

Podのspec.volumeMountsもminikube上を見に行くので同様の原因でエラーとなりました。
こちらはminikube環境にssh接続して環境操作する方法にて解決できました。
（参考資料）
stackoverflow