任务

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

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,请选择以下方式之一进行安装:

KVM,也使用了 QEMU

VirtualBox

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 上的 releases 找到 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,请选择以下方式之一进行安装:

HyperKit

VirtualBox

VMware 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-V

VirtualBox

注意:

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。在下面提到 <driver_name> 的地方,用小写字母,输入你安装的 hypervisor 的名称。 指定 VM 驱动程序 列举了 --vm-driver 值的完整列表

minikube start --vm-driver=<driver_name>

一旦 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

接下来

反馈