Docker Desktop for Mac 从 Docker Community Edition 18.06.0-ce-mac70 2018-07-25 版本起,添加了对 Kubernetes 的支持,可以方便的在 Mac 上运行一个单节点的 K8s 集群。
在 Docker Desktop 的 Preferences
中的 Kubernetes
页面里,提供了一个 Enable Kubernetes
选框,点击之后即可在 Mac 上启动 K8s。
然而点击之后,就没有然后了,一直是下图这个状态:
此问题的主要原因,是 K8s 运行所需的一些 k8s.gcr.io
下的镜像,无法直接下载得到。
准备镜像
配置镜像服务
在 Preferences
=> Docker Engine
里,可以配置 registry-mirrors
,国内可用的一些镜像服务有:
中国科大:https://docker.mirrors.ustc.edu.cn / https://ustc-edu-cn.mirror.aliyuncs.com
阿里云:https://xxxxx.mirror.aliyuncs.com,可使用阿里云账号在 这里 获得
网易云:https://hub-mirror.c.163.com
DaoCloud:http://f1361db2.m.daocloud.io
另外,中国科大还有 GCR 和 Quay 的镜像。
可添加多个镜像,如:
{ "registry-mirrors": [ "https://xxxxx.mirror.aliyuncs.com", "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com", "http://f1361db2.m.daocloud.io" ], "debug": true, "experimental": true}
之后点击 Apply & Restart
应用配置。
下载镜像
在 阿里云容器服务的 GitHub 组织 下,有个 k8s-for-docker-desktop 仓库即为解决此问题而存在。解决的方式为:先从阿里云下载所需的镜像副本至本地,再将镜像 tag 修改至 k8s.gcr.io
下。
以如下软件版本为例:
可使用 当前 master 分支最新的内容,直接执行 load_images.sh
完成镜像的下载及 tag 修改。
下载之后的镜像包括如下 8 个,与 images.properties 中内容一一对应:
$ docker imagesREPOSITORY TAG IMAGE ID CREATED SIZEk8s.gcr.io/kube-proxy v1.19.3 cdef7632a242 3 weeks ago 118MBk8s.gcr.io/kube-apiserver v1.19.3 a301be0cd44b 3 weeks ago 119MBk8s.gcr.io/kube-controller-manager v1.19.3 9b60aca1d818 3 weeks ago 111MBk8s.gcr.io/kube-scheduler v1.19.3 aaefbfa906bd 3 weeks ago 45.7MBk8s.gcr.io/etcd 3.4.13-0 0369cf4303ff 2 months ago 253MBk8s.gcr.io/coredns 1.7.0 bfe3a36ebd25 4 months ago 45.2MBk8s.gcr.io/pause 3.2 80d28bedfe5d 8 months ago 683kBquay.io/kubernetes-ingress-controller/nginx-ingress-controller 0.26.1 29024c9c6e70 13 months ago 483MB
其他版本?
如果使用的不是上图中的版本,且 k8s-for-docker-desktop
仓库还没有支持该版本时,可根据 K8s 版本通过如下方式获得 images.properties
中对应版本信息:
安装 K8s 对应版本的 kubeadm ,之后运行:
# 替换 ${KUBERNETES_VERSION} 为所使用的 K8s 版本$ ./kubeadm config images list --kubernetes-version=${KUBERNETES_VERSION}
可得到类似如下信息:
k8s.gcr.io/kube-apiserver:v1.19.3
k8s.gcr.io/kube-controller-manager:v1.19.3
k8s.gcr.io/kube-scheduler:v1.19.3
k8s.gcr.io/kube-proxy:v1.19.3
k8s.gcr.io/pause:3.2
k8s.gcr.io/etcd:3.4.13-0
k8s.gcr.io/coredns:1.7.0
也可参照这个 entrypoint.sh 中的 内容 ,或直接从 这个 定期执行的 GitHub Actions 记录中找到对应版本执行时的输出信息,如 v1.19.3 记录。
根据所得到的对应版本镜像信息,修改 images.properties
文件中内容,再执行 load_images.sh
即可。
依旧 Starting ?
在完成镜像下载并重启 Docker Desktop 之后,K8s 依旧停留在 Starting 状态。
通过
$ pred='process matches ".*(ocker|vpnkit).*"
|| (process in {"taskgated-helper", "launchservicesd", "kernel"} && eventMessage contains[c] "docker")'/usr/bin/log stream --style syslog --level=debug --color=always --predicate "$pred"
查看日志,发现不断输出如下内容:
2020-11-07 01:01:48.307809+0800 localhost com.docker.driver.amd64-linux[2646]: cannot get lease for master node: an error on the server ("") has prevented the request from succeeding (get leases.coordination.k8s.io docker-desktop)
2020-11-07 01:01:48.308417+0800 localhost com.docker.backend[1833]: external: POST /events 200 "DockerDesktopGo" ""
2020-11-07 01:01:49.231052+0800 localhost com.docker.driver.amd64-linux[2646]: (libsystem_info.dylib) [com.apple.network.libinfo:getaddrinfo] nat64_v4_requires_synthesis(127.0.0.1) == false
按照 这里 及 这里 提到的方式,删除掉 pki
文件夹:
$ rm -rf ~/Library/Group\ Containers/group.com.docker/pki/
之后再重启并观察日志,上述问题不再出现,并且新下载了 3 个 desktop 相关的镜像:
$ docker images | grep desktopdocker/desktop-kubernetes kubernetes-v1.19.3-cni-v0.8.5-critools-v1.17.0 7f85afe431d8 3 weeks ago 285MBdocker/desktop-storage-provisioner v1.1 e704287ce753 7 months ago 41.8MBdocker/desktop-vpnkit-controller v1.0 79da37e5a3aa 8 months ago 36.6MB
等待一会之后,终于变成 Running 状态了!
Tips: 如果还是 Starting 状态,可以尝试将当前安装的 Docker Desktop 环境都清理掉,全新安装一个稳定版本,可能就不会有奇怪的问题了。
另外,在没开启
Preferences
=>Kubernetes
中的Show system containers (advanced)
选项时,docker ps
是看不到 K8s 相关的容器的。