Add per-OS pages

pull/4935/head
Thomas Stromberg 2019-08-01 13:16:11 -07:00
parent f93b684dec
commit 92aaa2a2ea
5 changed files with 214 additions and 0 deletions

View File

@ -0,0 +1,7 @@
Use any regular Kubernetes command to interact with your minikube cluster. For example, you can see the pod states by running:
```shell
kubectl get po -A
```
Visit the [examples](/docs/examples) page to get a fuller idea of what you can do with minikube.

View File

@ -0,0 +1,5 @@
Just download the latest version from https://www.virtualbox.org/. No flags necessary:
```shell
minikube start
```

View File

@ -0,0 +1,97 @@
---
title: "Linux"
linkTitle: "Linux"
weight: 1
description: >
How to install and start minikube on Linux.
---
## Installation
{{% tabs %}}
{{% tab "Manual" %}}
Download and install minikube to /usr/local/bin:
```shell
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
&& sudo install minikube-linux-amd64 /usr/local/bin/minikube
```
{{% /tab %}}
{{% tab "Debian/Ubuntu (apt)" %}}
{{% /tab %}}
{{% tab "Fedora/Red Hat (rpm)" %}}
{{% /tab %}}
{{% /tabs %}}
## Hypervisor Setup
Verify that your system has virtualization support enabled:
```shell
egrep -q 'vmx|svm' /proc/cpuinfo && echo yes || echo no
```
If the above command outputs "no":
- If you are running within a VM, your hypervisor does not allow nested virtualization. You will need to use the *None (bare-metal)* driver
- If you are running on a physical machine, ensure that your BIOS has hardware virtualization enabled
{{% tabs %}}
{{% tab "VirtualBox" %}}
{{% readfile file="/docs/Getting started/_virtualbox.md" %}}
{{% /tab %}}
{{% tab "KVM" %}}
The KVM driver requires libvirt and qemu-kvm to be installed:
- Debian or Ubuntu 18.x: `sudo apt install libvirt-clients libvirt-daemon-system qemu-kvm`
- Ubuntu 16.x or older: `sudo apt install libvirt-bin libvirt-daemon-system qemu-kvm`
- Fedora/CentOS/RHEL: `sudo yum install libvirt libvirt-daemon-kvm qemu-kvm`
- openSUSE/SLES: `sudo zypper install libvirt qemu-kvm`
Additionally, The KVM driver requires an additional binary to be installed:
```shell
curl -LO https://storage.googleapis.com/minikube/releases/latest/docker-machine-driver-kvm2 \
&& sudo install docker-machine-driver-kvm2 /usr/local/bin/
```
### Validate libvirt
Before trying minikube, assert that libvirt is in a healthy state:
```shell
virt-host-validate
```
If you see any errors, stop now and consult your distributions documentation on configuring libvirt.
### Trying the kvm2 driver
```shell
minikube start --vm-driver=kvm2
```
### Making the kvm2 driver the default
```shell
minikube config set vm-driver kvm2
```
{{% /tab %}}
{{% tab "None (bare-metal)" %}}
If you are already running minikube from inside a VM, it is possible to skip the creation of an additional VM layer by using the `none` driver. It does require sudo access:
```shell
sudo minikube start --vm-driver=none
```
Please see the [docs/reference/drivers/none](none driver) documentation for more information.
{{% /tab %}}
{{% /tabs %}}
## Where should I go next?
{{% readfile file="/docs/Getting started/_next_steps.md" %}}

View File

@ -0,0 +1,61 @@
---
title: "macOS"
linkTitle: "macOS"
weight: 2
description: >
How to install and start minikube on macOS.
---
### Prerequisites
* macOS 10.12 (Sierra)
* A hypervisor such as Hyperkit, Parallels, VirtualBox, or VMware Fusion
### Installation
{{% tabs %}}
{{% tab "Brew" %}}
Download and install minikube to /usr/local/bin:
```shell
brew install minikube
```
{{% /tab %}}
{{% tab "Manual" %}}
Download and install minikube to /usr/local/bin:
```shell
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
&& sudo install minikube-darwin-amd64 /usr/local/bin/minikube
```
{{% /tab %}}
{{% /tabs %}}
## Hypervisor Setup
{{% tabs %}}
{{% tab "VirtualBox" %}}
{{% readfile file="/docs/Getting started/_virtualbox.md" %}}
{{% /tab %}}
{{% tab "Hyperkit" %}}
```shell
curl -LO https://storage.googleapis.com/minikube/releases/latest/docker-machine-driver-hyperkit \
&& sudo install docker-machine-driver-hyperkit /usr/local/bin/
sudo chown root:wheel /usr/local/bin/docker-machine-driver-hyperkit
sudo chmod u+s /usr/local/bin/docker-machine-driver-hyperkit
```
{{% /tab %}}
{{% tab "Parallels" %}}
{{% /tab %}}
{{% tab "VMWare Fusion" %}}
{{% /tab %}}
{{% /tabs %}}

View File

@ -0,0 +1,44 @@
---
title: "Windows"
linkTitle: "Windows"
weight: 3
description: >
How to install and start minikube on Windows.
---
### Prerequisites
* A hypervisor, such as VirtualBox (recommended) or HyperV
* VT-x/AMD-v virtualization must be enabled in BIOS
### Installation
Download and run the [installer](https://storage.googleapis.com/minikube/releases/latest/minikube-installer.exe)
## Try it out!
Start your first Kubernetes cluster:
```shell
minikube start
```
If `kubectl` is installed, this will show a status of all of the pods:
```shell
kubectl get po -A
```
## Further Setup
Once you have picked a hypervisor, you may set it as the default for future invocations:
```shell
minikube config set vm-driver <driver>
```
minikube only allocates a 2GB of RAM to Kubernetes, which is only enough for basic deployments. If you run into stability issues, increase this value if your system has the resources available:
```shell
minikube config set memory 4096
```