使用Minikube构建镜像时出现连接错误应如何排查解决？

• 版本不兼容：本地安装的docker-compose版本过高，和Minikube内置的Docker daemon版本不匹配。高版本docker-compose默认使用BuildKit作为构建后端，而旧版本Minikube内置的Docker daemon未开启或不支持BuildKit的h2c通信协议，就会触发该RPC连接错误。
• Minikube Docker daemon配置异常：Minikube默认启动的Docker daemon未开启BuildKit支持，当本地docker-compose强制走BuildKit构建时，协议握手失败返回404。
• 环境变量冲突：执行eval $(minikube docker-env)后，本地Docker相关环境变量已经切换到Minikube侧，但docker-compose仍读取了本地的BuildKit相关配置，未适配Minikube的Docker环境。

• 验证版本匹配情况：切换到Minikube Docker环境后分别执行docker version和docker-compose version，对比Minikube内置Docker server版本和本地docker-compose版本，如果docker-compose版本≥v2.0，且Minikube Docker server版本≤20.10.9，基本可判定为版本兼容问题。
• 临时关闭BuildKit测试：执行DOCKER_BUILDKIT=0 docker-compose build myimage，如果构建正常即可确认是BuildKit协议不匹配导致的问题。
• 检查Minikube Docker daemon配置：执行minikube ssh进入节点，执行ps aux | grep dockerd查看启动参数，确认是否存在--features buildkit=true的配置。

• 方法1：临时关闭BuildKit执行构建
  每次执行docker-compose构建前增加环境变量即可：
  DOCKER_BUILDKIT=0 docker-compose build myimage
  也可以在当前终端设置永久生效：
  export DOCKER_BUILDKIT=0

• 方法2：开启Minikube内置Docker的BuildKit支持
  启动Minikube时增加配置参数开启BuildKit：
  minikube start --feature-gates=BuildKit=true
  如果已经启动了Minikube，可以执行下面的命令修改配置后重启：

minikube ssh
sudo sed -i 's/^DOCKER_OPTS="/DOCKER_OPTS="--features buildkit=true /' /etc/default/docker
sudo systemctl restart docker
exit

配置生效后重新执行eval $(minikube docker-env)即可正常构建。

• 方法3：降级本地docker-compose版本
  如果不想修改Minikube配置，可以将本地docker-compose版本降级到v1.29.x版本，该版本默认不启用BuildKit，不会触发协议不兼容问题。

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