您正在查看 Kubernetes 版本的文档: v1.18

Kubernetes v1.18 版本的文档已不再维护。您现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本。

Edit This Page

安装 Minikube

本页面讲述如何安装 Minikube,该工具用于在你电脑中的虚拟机上运行一个单节点的 Kubernetes 集群。

准备开始

若要检查你的 Linux 是否支持虚拟化技术,请运行下面的命令并验证输出结果是否不为空:

grep -E --color 'vmx|svm' /proc/cpuinfo

若要检查你的 macOS 是否支持虚拟化技术,请运行下面的命令:

sysctl -a | grep -E --color 'machdep.cpu.features|VMX'

如果你在输出结果中看到了 VMX (应该会高亮显示)的字眼,说明你的电脑已启用 VT-x 特性。

若要检查你的 Windows8 及以上的系统是否支持虚拟化技术,请终端或者 cmd 中运行以下命令:

systeminfo

如果你看到下面的输出,则表示该 Windows 支持虚拟化技术。

Hyper-V Requirements:     VM Monitor Mode Extensions: Yes
                          Virtualization Enabled In Firmware: Yes
                          Second Level Address Translation: Yes
                          Data Execution Prevention Available: Yes

如果你看到下面的输出,则表示你的操作系统已经安装了 Hypervisor,你可以跳过安装 Hypervisor 的步骤。

Hyper-V Requirements:     A hypervisor has been detected. Features required for Hyper-V will not be displayed.

安装 minikube

安装 kubectl

请确保你已正确安装 kubectl。你可以根据安装并设置 kubectl 的说明来安装 kubectl。

安装 Hypervisor

如果还没有装过 hypervisor,请选择以下方式之一进行安装:

Minikube 还支持使用一个 --vm-driver=none 选项,让 Kubernetes 组件运行在主机上,而不是在 VM 中。 使用这种驱动方式需要 Docker 和 Linux 环境,但不需要 hypervisor。

如果你在 Debian 系的 OS 中使用了 none 这种驱动方式,请使用 .deb 包安装 Docker,不要使用 snap 包的方式,Minikube 不支持这种方式。 你可以从 Docker 下载 .deb 包。

注意: none VM 驱动方式存在导致安全和数据丢失的问题。 使用 --vm-driver=none 之前,请参考这个文档获取详细信息。

Minikube 还支持另外一个类似于 Docker 驱动的方式 vm-driver=podman。 使用超级用户权限(root 用户)运行 Podman 可以最好的确保容器具有足够的权限使用 你的操作系统上的所有特性。

注意: Podman 驱动需要以 root 用户身份运行容器,因为普通用户帐户没有足够的权限 使用容器运行可能需要的操作系统上的所有特性。

使用包安装 Minikube

Minikube 有 实验性 的安装包。你可以在 Minikube 在 GitHub 上的发行版本 找到 Linux (AMD64) 的包。

根据你的 Linux 发行版选择安装合适的包。

直接下载并安装 Minikube

如果你不想通过包安装,你也可以下载并使用一个单节点二进制文件。

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
  && chmod +x minikube

将 Minikube 可执行文件添加至 PATH:

sudo mkdir -p /usr/local/bin/
sudo install minikube /usr/local/bin/

使用 Homebrew 安装 Minikube

你还可以使用 Linux Homebrew 安装 Minikube:

brew install minikube

安装 kubectl

请确保你已正确安装 kubectl。你可以根据安装并设置 kubectl 的说明来安装 kubectl。

安装 Hypervisor

如果你还没有安装 hypervisor,请选择以下方式之一进行安装:

HyperKitVirtualBoxVMware Fusion

安装 Minikube

macOS 安装 Minikube 最简单的方法是使用 Homebrew

brew install minikube

你也可以通过下载独立的可执行文件进行安装:

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
  && chmod +x minikube

下面是一个简单的将 Minikube 可执行文件添加至 PATH 的方法:

sudo mv minikube /usr/local/bin

安装 kubectl

请确保你已正确安装 kubectl。你可以根据安装并设置 kubectl 的说明来安装 kubectl。

安装 Hypervisor

如果你还没有安装 hypervisor,请选择以下方式之一进行安装:

Hyper-VVirtualBox

说明: Hyper-V 可以运行在三个版本的 Windows 10 上:企业版、专业版和教育版(Enterprise, Professional, Education)。

使用 Chocolatey 安装 Minikube

Windows 安装 Minikube 最简单的方法是使用 Chocolatey (以管理员身份运行):

choco install minikube

完成 Minikube 的安装后,关闭当前 CLI 界面再重新打开。 Minikube 应该已经自动添加至 path 中。

使用安装程序安装 Minikube

在 Windows 上使用 Windows Installer 手动安装 Minikube,下载并运行 minikube-installer.exe 即可。

直接下载并安装 Minikube

想在 Windows 上手动安装 Minikube,下载 minikube-windows-amd64 并将其重命名为 minikube.exe,然后将其添加至 path 即可。

安装确认

要确认 hypervisor 和 Minikube 均已成功安装,可以运行以下命令来启动本地 Kubernetes 集群:

说明: 若要为 minikube start 设置 --vm-driver,在下面提到 <驱动名称> 的地方, 用小写字母输入你安装的 hypervisor 的名称。 指定 VM 驱动程序 列举了 --vm-driver 值的完整列表。
说明: 由于国内无法直接连接 k8s.gcr.io,推荐使用阿里云镜像仓库,在 minikube start 中添加 --image-repository 参数。
minikube start --vm-driver=<驱动名称>
# 或者在需要时
minikube start --vm-driver=<驱动名称> --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers

一旦 minikube start 完成,你可以运行下面的命令来检查集群的状态:

minikube status

如果你的集群正在运行,minikube status 的输出结果应该类似于这样:

host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

在确认 Minikube 与 hypervisor 均正常工作后,你可以继续使用 Minikube 或停止集群。要停止集群,请运行:

minikube stop

清理本地状态

如果你之前安装过 Minikube,并运行了:

minikube start

并且 minikube start 返回了一个错误:

machine does not exist

那么,你需要清理 minikube 的本地状态:

minikube delete

接下来