启动Minishift时执行'cluster up'环节出现错误求助

问题详情 #

执行minishift start命令时启动集群失败，具体报错信息如下：

执行'cluster up'时出错：启动集群失败。SSH命令错误：
command : /var/lib/minishift/bin/oc cluster up --base-dir /var/lib/minishift/base --image 'openshift/origin-${component}:v3.11.0' --public-hostname 192.168.42.204 --routing-suffix 192.168.42.204.nip.io
err     : exit status 1
output  : 获取Docker客户端...
检查镜像openshift/origin-control-plane:v3.11.0是否可用...
拉取镜像openshift/origin-cli:v3.11.0
E1105 12:27:47.021019    2182 helper.go:173] 读取/home/docker/.docker/config.json配置文件失败：文件不存在，将尝试匿名拉取镜像docker.io/openshift/origin-cli:v3.11.0
镜像拉取完成
拉取镜像openshift/origin-node:v3.11.0
E1105 12:27:52.443620    2182 helper.go:173] 读取/home/docker/.docker/config.json配置文件失败：文件不存在，将尝试匿名拉取镜像docker.io/openshift/origin-node:v3.11.0
已拉取5/6层，完成86%
已拉取6/6层，完成100%
解压中
镜像拉取完成
检查卷挂载类型...
确定服务器IP...
使用公网主机名IP 192.168.42.204作为主机IP
检查OpenShift是否已在运行...
检查是否为支持的Docker版本(>=1.22)...
检查Docker中是否正确配置了非安全镜像仓库...
检查所需端口是否可用...
检查OpenShift客户端是否配置正确...
检查镜像openshift/origin-control-plane:v3.11.0是否可用...
正在使用openshift/origin-control-plane:v3.11.0启动OpenShift...

解决步骤 #

• 修复Docker配置文件缺失问题
  手动创建缺失的Docker配置文件并设置正确权限：

  sudo mkdir -p /home/docker/.docker
  sudo touch /home/docker/.docker/config.json
  sudo chown docker:docker /home/docker/.docker/config.json
  

• 验证Docker版本兼容性
  检查Docker版本是否满足OpenShift v3.11的最低要求（>=1.22）：

  docker --version
  

  若版本不达标，升级至符合要求的版本后重新尝试启动。

• 排查端口占用情况
  检查OpenShift核心端口（80、443、8443等）是否被其他进程占用：

  sudo ss -tulpn | grep -E '80|443|8443'
  

  若存在占用，停止对应进程后再执行minishift start。

• 手动拉取关键镜像
  确保openshift/origin-control-plane:v3.11.0镜像完整：

  docker pull openshift/origin-control-plane:v3.11.0
  

• 重置Minishift环境
  若上述方法无效，重置Minishift后重新启动：

  minishift stop
  minishift delete
  minishift start
  

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