OS:macOS
GitHub:https://github.com/khs1994-docker/minikube
GitHub: https://github.com/kubernetes/minikube
本文基于 0.25.0 版本
修订记录
2018-01-27:Minikube 0.25.0 已经发布,请查看阿里云文章:https://yq.aliyun.com/articles/221687
2018-01-15:请在之前看过我文章的务必按照本文重新安装配置 minikube
2018-01-15:由于阿里云的 localkube 出现问题(已反馈给相关人员),暂时只能使用我编译的 localkube。
特别注意
请直接查看 阿里云文章 不要再按本文方法使用。
镜像列表
1 | gcr.io/google_containers/kubernetes-dashboard-amd64 v1.8.0 55dbc28356f2 6 weeks ago 119MB |
本人也是初学 minikube
,本文基于 minikube
0.24.1 版本。
如果我们直接使用从 https://github.com/kubernetes/minikube 下载的 minikube
你可能会发现根本不能运行成功。
这是因为它要从 gcr.io
拉取镜像,而国内网络问题导致镜像下载不了,当然也就不能启动了。
知道为什么成功不了,那我们就替换源码中的国外镜像为国内镜像源(阿里云)。
具体要变更哪些文件请看 GitHub
我已经把变更过的文件上传到了 GitHub,本文以这个 git 仓库为源码,重新编译 minikube
安装 kubectl
注意,由于网络问题,从官网下载极有可能下载失败。你可以使用浏览器在国内镜像下载之后移入
PATH
https://github.com/khs1994-docker/kubectl-cn-mirror
使用 minikube
必须先安装好 k8s
命令行工具 kubectl
。
macOS
Docker for Mac
17.12+ 启用 k8s
之后会在 /usr/local/bin
放入 kubectl
,所以你无需安装。
Docker for Mac
自带的 k8s
会与 minikube
冲突,请以下命令进行切换。
1 | $ kubectl config get-contexts |
如果你没启用 k8s
那么请使用下面的方法。
1 | $ brew install kubectl |
curl
或者使用 curl
下载。
bash
1 | # OS X |
fish
1 | # OS X |
重新安装 minikube
国内版
注意:国内从 GitHub 下载文件可能较慢,你可以在国内镜像下载之后移入
PATH
https://code.aliyun.com/khs1994-docker/minikube/tree/v1.8.0
你可以选择 编译安装
或者 下载安装
。为了避免混乱,编译安装的方法,放到了文章最后。
直接下载安装
你可以根据你的操作系统,下载对应的二进制文件。你也可以在命令行使用 curl 下载。
https://github.com/khs1994-docker/minikube/releases
bash
1 | $ curl -LO https://github.com/khs1994-docker/minikube/releases/download/v0.24.1/minikube-`uname -s`-`uname -m` |
fish
1 | $ curl -LO https://github.com/khs1994-docker/minikube/releases/download/v0.24.1/minikube-(uname -s)-(uname -m) |
虚拟机驱动
https://github.com/kubernetes/minikube/blob/master/docs/drivers.md
macOS
上默认的驱动是 VirtualBox
,但是我们这里选择 hyperkit
。
注意,你可能看到一些旧教程使用了
xhyve
,如果你使用这个驱动,启动时minikube
会提示你该驱动已经废弃。
1 | WARNING: The xhyve driver is now deprecated and support for it will be removed in a future release. |
1 | $ curl -LO https://github.com/kubernetes/minikube/releases/download/v0.24.1/docker-machine-driver-hyperkit |
这样我们就安装好了驱动。
启动
1 | $ minikube start --vm-driver=hyperkit --alsologtostderr --v 10 |
选择一种驱动之后,不要再改变,否则可能会启动失败。
错误排查
若启动时出现错误,请执行以下命令删除本地集群,再重新执行启动命令。
1 | $ minikube delete |
如果仍然出现错误请删除 ~/.minikube
,再重新执行启动命令。
使用方法
打开控制面板
1 | $ minikube dashboard |
之后会自动打开浏览器页面。
查看 IP
1 | $ minikube ip |
查看状态
1 | $ minikube status |
查看集群
1 | $ kubectl cluster-info |
更多方法请查看后续文章。
关闭
1 | $ minikube stop |
附录
Windows 启动 minikube
自行在上面提到的 GitHub 或 国内镜像 下载好 kubectl.exe
minikube.exe
,并加入 PATH
配置 Hyper-V
,具体图解请查看:https://yq.aliyun.com/articles/221687
1 | $ minikube.exe start --registry-mirror=https://registry.docker-cn.com --vm-driver="hyperv" --memory=4096 --hyperv-virtual-switch="minikube" |
编译安装 minikube
注意:编译安装适用于对
Go
有一定了解的人。
安装 Go
1 | $ brew install go |
设置 Go
相关环境变量,自行修改为你自己的路径。
1 | GOROOT="/usr/local/opt/go/libexec" |
编译安装
1 | $ git clone -b 0.24.1 --depth=1 git@github.com:khs1994-docker/minikube.git $GOPATH/src/k8s.io/minikube |