Add per-OS pages
parent
f93b684dec
commit
92aaa2a2ea
|
@ -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.
|
|
@ -0,0 +1,5 @@
|
|||
Just download the latest version from https://www.virtualbox.org/. No flags necessary:
|
||||
|
||||
```shell
|
||||
minikube start
|
||||
```
|
|
@ -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" %}}
|
|
@ -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 %}}
|
|
@ -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
|
||||
```
|
Loading…
Reference in New Issue