Skip to content
Run Kubernetes locally
Branch: master
Clone or download
k8s-ci-robot Merge pull request #3895 from igorakkerman/bugfix/windows-install-loc…
…ation

Windows installer using installation path for x64 applications
Latest commit 89f9ca6 Mar 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE Mar 11, 2019
cmd Merge branch 'master' into cache_images_int_test2 Mar 6, 2019
deploy Fix `minikube addons open heapster` Mar 7, 2019
docs Document hack/tag_release.sh Mar 11, 2019
hack Merge pull request #3838 from afbjorklund/dos Mar 13, 2019
images Make images subdirectory, add start image Feb 16, 2019
installers Windows installer using installation path for x64 applications Mar 17, 2019
pkg Merge pull request #3767 from tstromberg/cache_images_int_test2 Mar 14, 2019
test/integration Refactor functional tests to not rely on SetRuntime, use short variab… Mar 8, 2019
third_party/go9p go fmt Oct 31, 2018
vendor Update docker/machine to fix the AMD bug Mar 6, 2019
.codecov.yml Disable codecov comment bot Aug 4, 2017
.dockerignore Add a .dockerignore to make image builds faster. Nov 6, 2017
.gitignore Added .vscode to .gitignore Apr 7, 2017
.travis.yml Let Travis track the latest stable Go 1.x release. Oct 4, 2018
CHANGELOG.md Fix v0.35.0 date Mar 7, 2019
CONTRIBUTING.md Update CLA link Jan 2, 2018
Gopkg.lock Update docker/machine to fix the AMD bug Mar 6, 2019
Gopkg.toml Merge from hell #2: refactor start.go because it's terrible Feb 8, 2019
LICENSE Update License file Apr 15, 2016
MAINTAINERS Add afbjorklund to maintainers Jan 20, 2019
Makefile Update Makefile to 0.35.0 Mar 6, 2019
OWNERS Updated OWNERS file to include link to docs Feb 4, 2019
README.md Add v0.35.0 Mar 7, 2019
SECURITY_CONTACTS Update embargo doc link in SECURITY_OWNERS and changes PST to PSC Mar 8, 2019
code-of-conduct.md Update code-of-conduct.md Dec 20, 2017
makedepend.sh Avoid out directory, when listing test files Oct 6, 2018
test.sh Merge pull request #3229 from afbjorklund/makedepend-buildroot Jan 16, 2019

README.md

minikube

BuildStatus Widget GoReport Widget

What is minikube?

minikube implements a local Kubernetes cluster on macOS, Linux, and Windows.

Our goal is to enable fast local development and to support all Kubernetes features that fit. We hope you enjoy it!

News

Features

minikube runs the official stable release of Kubernetes, with support for standard Kubernetes features like:

As well as developer-friendly features:

  • Addons - a marketplace for developers to share configurations for running services on minikube
  • GPU support - for machine learning
  • Filesystem mounts
  • Automatic failure analysis

Documentation

Community

minikube is a Kubernetes #sig-cluster-lifecycle project.

Installation

See the installation guide. For the impatient, here is the TL;DR:

  • macOS 10.12 (Sierra)

    • Requires installing a hypervisor, such as hyperkit (recommended) or VirtualBox
    • using brew: brew cask install minikube
    • manually: curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 && sudo install minikube-darwin-amd64 /usr/local/bin/minikube
  • Windows 10

    • Requires a hypervisor, such as VirtualBox (recommended) or HyperV
    • VT-x/AMD-v virtualization must be enabled in BIOS
    • using chocolatey choco install minikube
    • manually: Download and run the installer
  • Linux

    • Requires either the kvm2 driver (recommended), or VirtualBox
    • VT-x/AMD-v virtualization must be enabled in BIOS
    • manually: curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 && sudo install minikube-linux-amd64 /usr/local/bin/minikube

Supported Hypervisors

minikube start defaults to virtualbox, but supports other drivers using the --vm-driver argument:

  • KVM2 - Recommended Linux driver
  • hyperkit - Recommended macOS driver
  • virtualbox - Recommended Windows driver
  • none - bare-metal execution on Linux, at the expense of system security and reliability

Other drivers which are not yet part of our continuous integration system are:

Quick Start

Start a cluster by running:

minikube start

Once started, you can interact with your cluster using kubectl, just like any other Kubernetes cluster. For instance, starting a server:

kubectl run hello-minikube --image=k8s.gcr.io/echoserver:1.4 --port=8080

Exposing a service as a NodePort

kubectl expose deployment hello-minikube --type=NodePort

minikube makes it easy to open this exposed endpoint in your browser:

minikube service hello-minikube

Start a second local cluster:

minikube start -p cluster2

Stop your local cluster:

minikube stop

Delete your local cluster:

minikube delete

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.