Split minikube install task into tabs (per-OS) (#14013)

* Put minikube install steps in per-OS tabs

* Work around nested <li> formatting issue

Using Markdown unordered lists inside tabs doesn't seem to work. These
changes are my work-around for that.

* Reword "laptop" to personal computer

Some computers aren't laptops

* Drop trailing whitespace

* Drop warning about removing other Mac hypervisors
This commit is contained in:
Tim Bannister
2019-06-11 03:50:16 +01:00
committed by Kubernetes Prow Robot
parent 7b44b7a3df
commit 5c3e7955fb
+76 -40
View File
@@ -9,18 +9,16 @@ card:
{{% capture overview %}} {{% capture overview %}}
This page shows you how to install [Minikube](/docs/tutorials/hello-minikube), a tool that runs a single-node Kubernetes cluster in a virtual machine on your laptop. This page shows you how to install [Minikube](/docs/tutorials/hello-minikube), a tool that runs a single-node Kubernetes cluster in a virtual machine on your personal computer.
{{% /capture %}} {{% /capture %}}
{{% capture prerequisites %}} {{% capture prerequisites %}}
VT-x or AMD-v virtualization must be enabled in your computer's BIOS.
{{< tabs name="minikube_before_you_begin" >}} {{< tabs name="minikube_before_you_begin" >}}
{{% tab name="Linux" %}} {{% tab name="Linux" %}}
To check if virtualization is supported on Linux, run the following command and verify that the output is non-empty: To check if virtualization is supported on Linux, run the following command and verify that the output is non-empty:
``` ```shell
egrep --color 'vmx|svm' /proc/cpuinfo egrep --color 'vmx|svm' /proc/cpuinfo
``` ```
{{% /tab %}} {{% /tab %}}
@@ -57,35 +55,74 @@ Hyper-V Requirements: A hypervisor has been detected. Features required for
{{% capture steps %}} {{% capture steps %}}
## Install a Hypervisor # Installing minikube
If you do not already have a hypervisor installed, install one for your OS now: {{< tabs name="tab_with_md" >}}
{{% tab name="Linux" %}}
Operating system | Supported hypervisors ### Install kubectl
:----------------|:---------------------
macOS | [VirtualBox](https://www.virtualbox.org/wiki/Downloads), [VMware Fusion](https://www.vmware.com/products/fusion), [HyperKit](https://github.com/moby/hyperkit) Make sure you have kubectl installed. You can install kubectl according to the instructions in [Install and Set Up kubectl](/docs/tasks/tools/install-kubectl/#install-kubectl-on-linux).
Linux | [VirtualBox](https://www.virtualbox.org/wiki/Downloads), [KVM](http://www.linux-kvm.org/)
Windows | [VirtualBox](https://www.virtualbox.org/wiki/Downloads), [Hyper-V](https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install) ### Install a Hypervisor
If you do not already have a hypervisor installed, install one of these now:
• [KVM](https://www.linux-kvm.org/), which also uses QEMU
• [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
{{< note >}} {{< note >}}
Minikube also supports a `--vm-driver=none` option that runs the Kubernetes components on the host and not in a VM. Using this driver requires Docker and a Linux environment but not a hypervisor. Minikube also supports a `--vm-driver=none` option that runs the Kubernetes components on the host and not in a VM. Using this driver requires [Docker](https://www.docker.com/products/docker-desktop) and a Linux environment but not a hypervisor.
{{< /note >}} {{< /note >}}
## Install kubectl ### Install Minikube using a package
* Install kubectl according to the instructions in [Install and Set Up kubectl](/docs/tasks/tools/install-kubectl/). There are *experimental* packages for Minikube available; you can find Linux (AMD64) packages
from Minikube's [releases](https://github.com/kubernetes/minikube/releases) page on GitHub.
## Install Minikube Use your Linux's distribution's package tool to install a suitable package.
### macOS ### Install Minikube via direct download
If you're not installing via a package, you can download a stand-alone
binary and use that.
```shell
curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
&& chmod +x minikube
```
Here's an easy way to add the Minikube executable to your path:
```shell
sudo install minikube /usr/local/bin
```
{{% /tab %}}
{{% tab name="macOS" %}}
### Install kubectl
Make sure you have kubectl installed. You can install kubectl according to the instructions in [Install and Set Up kubectl](/docs/tasks/tools/install-kubectl/#install-kubectl-on-macos).
### Install a Hypervisor
If you do not already have a hypervisor installed, install one of these now:
• [HyperKit](https://github.com/moby/hyperkit)
• [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
• [VMware Fusion](https://www.vmware.com/products/fusion)
### Install Minikube
The easiest way to install Minikube on macOS is using [Homebrew](https://brew.sh): The easiest way to install Minikube on macOS is using [Homebrew](https://brew.sh):
```shell ```shell
brew cask install minikube brew cask install minikube
``` ```
You can also install it on macOS by downloading a static binary: You can also install it on macOS by downloading a stand-alone binary:
```shell ```shell
curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \ curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
@@ -98,30 +135,25 @@ Here's an easy way to add the Minikube executable to your path:
sudo mv minikube /usr/local/bin sudo mv minikube /usr/local/bin
``` ```
### Linux {{% /tab %}}
{{% tab name="Windows" %}}
### Install kubectl
Make sure you have kubectl installed. You can install kubectl according to the instructions in [Install and Set Up kubectl](/docs/tasks/tools/install-kubectl/#install-kubectl-on-windows).
### Install a Hypervisor
If you do not already have a hypervisor installed, install one of these now:
• [Hyper-V](https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install)
• [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
{{< note >}} {{< note >}}
This document shows you how to install Minikube on Linux using a static binary. Hyper-V can run on three versions of Windows 10: Windows 10 Enterprise, Windows 10 Professional, and Windows 10 Education.
{{< /note >}} {{< /note >}}
You can install Minikube on Linux by downloading a static binary: ### Install Minikube using Chocolatey
```shell
curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
&& chmod +x minikube
```
Here's an easy way to add the Minikube executable to your path:
```shell
sudo cp minikube /usr/local/bin && rm minikube
```
### Windows
{{< note >}}
To run Minikube on Windows, you first need to install [VirtualBox](https://www.virtualbox.org/) or [Hyper-V](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v). Hyper-V can be run on three versions of Windows 10: Windows 10 Enterprise, Windows 10 Professional, and Windows 10 Education. See the official Minikube GitHub repository for additional [installation information](https://github.com/kubernetes/minikube/#installation).
{{< /note >}}
The easiest way to install Minikube on Windows is using [Chocolatey](https://chocolatey.org/) (run as an administrator): The easiest way to install Minikube on Windows is using [Chocolatey](https://chocolatey.org/) (run as an administrator):
@@ -131,13 +163,17 @@ choco install minikube kubernetes-cli
After Minikube has finished installing, close the current CLI session and restart. Minikube should have been added to your path automatically. After Minikube has finished installing, close the current CLI session and restart. Minikube should have been added to your path automatically.
#### Windows manual installation ### Install Minikube using an installer executable
To install Minikube manually on Windows using [Windows Installer](https://docs.microsoft.com/en-us/windows/desktop/msi/windows-installer-portal), download [`minikube-installer.exe`](https://github.com/kubernetes/minikube/releases/latest/minikube-installer.exe) and execute the installer.
### Install Minikube via direct download
To install Minikube manually on Windows, download [`minikube-windows-amd64`](https://github.com/kubernetes/minikube/releases/latest), rename it to `minikube.exe`, and add it to your path. To install Minikube manually on Windows, download [`minikube-windows-amd64`](https://github.com/kubernetes/minikube/releases/latest), rename it to `minikube.exe`, and add it to your path.
#### Windows Installer {{% /tab %}}
{{< /tabs >}}
To install Minikube manually on windows using [Windows Installer](https://docs.microsoft.com/en-us/windows/desktop/msi/windows-installer-portal), download [`minikube-installer.exe`](https://github.com/kubernetes/minikube/releases/latest) and execute the installer.
{{% /capture %}} {{% /capture %}}