From 359d5be6e5ffe8d338218a770793b6231ae15f4e Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Sun, 11 Oct 2020 10:32:38 +0800 Subject: [PATCH] [zh] Remove install-minikube This is a sync from En site. --- content/zh/docs/tasks/tools/_index.md | 103 ++++ .../zh/docs/tasks/tools/install-minikube.md | 446 ------------------ 2 files changed, 103 insertions(+), 446 deletions(-) delete mode 100644 content/zh/docs/tasks/tools/install-minikube.md diff --git a/content/zh/docs/tasks/tools/_index.md b/content/zh/docs/tasks/tools/_index.md index 922e13f0d3..56e271dbe9 100644 --- a/content/zh/docs/tasks/tools/_index.md +++ b/content/zh/docs/tasks/tools/_index.md @@ -2,4 +2,107 @@ title: "安装工具" weight: 10 description: 在你的计算机上设置 Kubernetes 工具。 +no_list: true --- + + + + +## kubectl + +Kubernetes 命令行工具,`kubectl`,使得你可以对 Kubernetes 集群运行命令。 +你可以使用 `kubectl` 来部署应用、监测和管理集群资源以及查看日志。 + +关于如何下载和安装 `kubectl` 并配置其访问你的集群,可参阅 +[安装和配置 `kubectl`](/zh/docs/tasks/tools/install-kubectl/)。 + + + +查看 kubectl 安装和配置指南 + + +你也可以阅读 [`kubectl` 参考文档](/zh/docs/reference/kubectl/). + + +## minikube + +[`minikube`](https://minikube.sigs.k8s.io/) 是一个工具,能让你在本地运行 Kubernetes。 +`minikube` 在你本地的个人计算机(包括 Windows、macOS 和 Linux PC)运行一个单节点的 +Kubernetes 集群,以便你来尝试 Kubernetes 或者开展每天的开发工作。 + +如果你关注如何安装此工具,可以按官方的 +[Get Started!](https://minikube.sigs.k8s.io/docs/start/)指南操作。 + + + +查看 minikube 快速入门指南 + + +当你拥有了可工作的 `minikube` 时,就可以用它来 +[运行示例应用](/zh/docs/tutorials/hello-minikube/)了。 + + +## kind + +与 `minikube` 类似,[`kind`](https://kind.sigs.k8s.io/docs/) 让你能够在本地计算机上 +运行 Kubernetes。与`minikube` 不同的是,`kind` 只能使用一种容器运行时: +它要求你安装并配置好 [Docker](https://docs.docker.com/get-docker/)。 + +[快速入门](https://kind.sigs.k8s.io/docs/user/quick-start/)页面提供了开始使用 +`kind` 所需要完成的操作。 + + +查看 kind 的快速入门指南 + + diff --git a/content/zh/docs/tasks/tools/install-minikube.md b/content/zh/docs/tasks/tools/install-minikube.md deleted file mode 100644 index 270524f109..0000000000 --- a/content/zh/docs/tasks/tools/install-minikube.md +++ /dev/null @@ -1,446 +0,0 @@ ---- -title: 安装 Minikube -content_type: task -weight: 20 -card: - name: tasks - weight: 10 ---- - - - - - - -本页面讲述如何安装 [Minikube](/zh/docs/tutorials/hello-minikube),该工具用于在你电脑中的虚拟机上运行一个单节点的 Kubernetes 集群。 - -## {{% heading "prerequisites" %}} - -{{< tabs name="minikube_before_you_begin" >}} -{{% tab name="Linux" %}} - - - -若要检查你的 Linux 是否支持虚拟化技术,请运行下面的命令并验证输出结果是否不为空: - -``` -grep -E --color 'vmx|svm' /proc/cpuinfo -``` - -{{% /tab %}} - -{{% tab name="macOS" %}} - - -若要检查你的 macOS 是否支持虚拟化技术,请运行下面的命令: - -``` -sysctl -a | grep -E --color 'machdep.cpu.features|VMX' -``` - - -如果你在输出结果中看到了 `VMX` (应该会高亮显示)的字眼,说明你的电脑已启用 VT-x 特性。 - -{{% /tab %}} - -{{% tab name="Windows" %}} - -若要检查你的 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. -``` - -{{% /tab %}} -{{< /tabs >}} - - - - -## 安装 minikube - -{{< tabs name="tab_with_md" >}} -{{% tab name="Linux" %}} - - -### 安装 kubectl - -请确保你已正确安装 kubectl。你可以根据[安装并设置 kubectl](/zh/docs/tasks/tools/install-kubectl/#install-kubectl-on-linux) -的说明来安装 kubectl。 - - - -### 安装 Hypervisor - -如果还没有装过 hypervisor,请选择以下方式之一进行安装: - - - -- [KVM](https://www.linux-kvm.org/),KVM 也使用了 QEMU -- [VirtualBox](https://www.virtualbox.org/wiki/Downloads) - - -Minikube 还支持使用一个 `--vm-driver=none` 选项,让 Kubernetes 组件运行在主机上,而不是在 VM 中。 -使用这种驱动方式需要 [Docker](https://www.docker.com/products/docker-desktop) 和 Linux 环境,但不需要 hypervisor。 - -如果你在 Debian 系的 OS 中使用了 `none` 这种驱动方式,请使用 `.deb` 包安装 Docker,不要使用 snap 包的方式,Minikube 不支持这种方式。 -你可以从 [Docker](https://www.docker.com/products/docker-desktop) 下载 `.deb` 包。 - - -{{< caution >}} -`none` VM 驱动方式存在导致安全和数据丢失的问题。 -使用 `--vm-driver=none` 之前,请参考[这个文档](https://minikube.sigs.k8s.io/docs/reference/drivers/none/)获取详细信息。 -{{< /caution >}} - - -Minikube 还支持另外一个类似于 Docker 驱动的方式 `vm-driver=podman`。 -使用超级用户权限(root 用户)运行 Podman 可以最好的确保容器具有足够的权限使用 -你的操作系统上的所有特性。 - - -{{< caution >}} -`Podman` 驱动需要以 root 用户身份运行容器,因为普通用户帐户没有足够的权限 -使用容器运行可能需要的操作系统上的所有特性。 -{{< /caution >}} - - -### 使用包安装 Minikube - -Minikube 有 *实验性* 的安装包。你可以在 Minikube 在 GitHub 上的[发行版本](https://github.com/kubernetes/minikube/releases) 找到 Linux (AMD64) 的包。 - -根据你的 Linux 发行版选择安装合适的包。 - - -### 直接下载并安装 Minikube - -如果你不想通过包安装,你也可以下载并使用一个单节点二进制文件。 - -```shell -curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \ - && chmod +x minikube -``` - - -将 Minikube 可执行文件添加至 PATH: - -```shell -sudo mkdir -p /usr/local/bin/ -sudo install minikube /usr/local/bin/ -``` - - -### 使用 Homebrew 安装 Minikube - -你还可以使用 Linux [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) 安装 Minikube: - -```shell -brew install minikube -``` - -{{% /tab %}} - -{{% tab name="macOS" %}} - - -### 安装 kubectl - -请确保你已正确安装 kubectl。你可以根据[安装并设置 kubectl](/zh/docs/tasks/tools/install-kubectl/#install-kubectl-on-linux) -的说明来安装 kubectl。 - - -### 安装 Hypervisor - -如果你还没有安装 hypervisor,请选择以下方式之一进行安装: - -• [HyperKit](https://github.com/moby/hyperkit) -• [VirtualBox](https://www.virtualbox.org/wiki/Downloads) -• [VMware Fusion](https://www.vmware.com/products/fusion) - - -### 安装 Minikube - -macOS 安装 Minikube 最简单的方法是使用 [Homebrew](https://brew.sh): - -```shell -brew install minikube -``` - - -你也可以通过下载独立的可执行文件进行安装: - -```shell -curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \ - && chmod +x minikube -``` - - -下面是一个简单的将 Minikube 可执行文件添加至 PATH 的方法: - -```shell -sudo mv minikube /usr/local/bin -``` - -{{% /tab %}} -{{% tab name="Windows" %}} - - -### 安装 kubectl - -请确保你已正确安装 kubectl。你可以根据[安装并设置 kubectl](/zh/docs/tasks/tools/install-kubectl/#install-kubectl-on-windows) -的说明来安装 kubectl。 - - -### 安装 Hypervisor - -如果你还没有安装 hypervisor,请选择以下方式之一进行安装: - -• [Hyper-V](https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install) -• [VirtualBox](https://www.virtualbox.org/wiki/Downloads) - - -{{< note >}} -Hyper-V 可以运行在三个版本的 Windows 10 上:企业版、专业版和教育版(Enterprise, Professional, Education)。 -{{< /note >}} - - -### 使用 Chocolatey 安装 Minikube - -Windows 安装 Minikube 最简单的方法是使用 [Chocolatey](https://chocolatey.org/) (以管理员身份运行): - -```shell -choco install minikube -``` - - -完成 Minikube 的安装后,关闭当前 CLI 界面再重新打开。 -Minikube 应该已经自动添加至 path 中。 - - - -### 使用安装程序安装 Minikube - -在 Windows 上使用 [Windows Installer](https://docs.microsoft.com/en-us/windows/desktop/msi/windows-installer-portal) 手动安装 Minikube,下载并运行 [`minikube-installer.exe`](https://github.com/kubernetes/minikube/releases/latest/download/minikube-installer.exe) 即可。 - - -### 直接下载并安装 Minikube - -想在 Windows 上手动安装 Minikube,下载 [`minikube-windows-amd64`](https://github.com/kubernetes/minikube/releases/latest) 并将其重命名为 `minikube.exe`,然后将其添加至 path 即可。 - -{{% /tab %}} -{{< /tabs >}} - - -## 安装确认 - -要确认 hypervisor 和 Minikube 均已成功安装,可以运行以下命令来启动本地 Kubernetes 集群: - - -{{< note >}} -若要为 `minikube start` 设置 `--vm-driver`,在下面提到 `<驱动名称>` 的地方, -用小写字母输入你安装的 hypervisor 的名称。 -[指定 VM 驱动程序](/zh/docs/setup/learning-environment/minikube/#specifying-the-vm-driver) -列举了 `--vm-driver` 值的完整列表。 -{{< /note >}} - -{{< note >}} -由于国内无法直接连接 k8s.gcr.io,推荐使用阿里云镜像仓库,在 `minikube start` 中添加 `--image-repository` 参数。 -{{< /note >}} - -```shell -minikube start --vm-driver=<驱动名称> -# 或者在需要时 -minikube start --vm-driver=<驱动名称> --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers -``` - - -一旦 `minikube start` 完成,你可以运行下面的命令来检查集群的状态: - -```shell -minikube status -``` - - -如果你的集群正在运行,`minikube status` 的输出结果应该类似于这样: - -``` -host: Running -kubelet: Running -apiserver: Running -kubeconfig: Configured -``` - - -在确认 Minikube 与 hypervisor 均正常工作后,你可以继续使用 Minikube 或停止集群。要停止集群,请运行: - -```shell -minikube stop -``` - - -## 清理本地状态 {#cleanup-local-state} - -如果你之前安装过 Minikube,并运行了: - -```shell -minikube start -``` - - -并且 `minikube start` 返回了一个错误: - -``` -machine does not exist -``` - - -那么,你需要清理 minikube 的本地状态: - -```shell -minikube delete -``` - -## {{% heading "whatsnext" %}} - - - -* [使用 Minikube 在本地运行 Kubernetes](/zh/docs/setup/learning-environment/minikube/) -