Go to file
Medya Ghazizadeh 53b37e2beb Separate make lint targets for developers vs travis (#4852)
* Lowering memory for golangci-lint

* ci 2 jobs , gogc 5

* change ci jobs number

* added a new make target for ci and for developers

* reuse golint options for two targets
2019-07-24 10:34:53 -07:00
.github/ISSUE_TEMPLATE making issue template less complex 2019-07-08 10:19:03 -07:00
cmd Warn if hyperkit version is old (#4691) 2019-07-22 15:35:42 -07:00
deploy Upgrade Docker, from 18.09.7 to 18.09.8 2019-07-19 14:49:57 +02:00
docs Warn if hyperkit version is old (#4691) 2019-07-22 15:35:42 -07:00
hack Merge pull request #4556 from afbjorklund/kvm2-packages 2019-07-16 10:05:37 +02:00
images Update start.jpg to v1.2 2019-06-24 16:21:38 +08:00
installers Change deb maintainer, lower case minikube 2019-07-14 09:32:19 +02:00
pkg Merge pull request #4525 from afbjorklund/distro 2019-07-23 12:50:00 +02:00
site Add basic hugo & netlify website structure 2019-06-15 09:27:05 +08:00
test/integration Merge pull request #4811 from medyagh/add_profile_list_cmd 2019-07-19 15:43:50 -07:00
third_party/go9p Better comment syntax 2019-07-05 11:17:10 +08:00
translations Console output cleanup (#4825) 2019-07-19 17:00:51 -07:00
.codecov.yml Disable codecov comment bot 2017-08-04 14:46:44 -07:00
.dockerignore Add a .dockerignore to make image builds faster. 2017-11-06 13:01:01 -08:00
.gitignore git ignore translations.go-e 2019-07-17 11:54:30 -07:00
.gitmodules Add basic hugo & netlify website structure 2019-06-15 09:27:05 +08:00
.markdownlint.json Run markdownlint on all the md files in docs 2019-03-10 20:06:04 +01:00
.travis.yml pinning go version in travis 2019-07-22 16:20:55 -07:00
CHANGELOG.md Add release notes for v1.2.0 2019-06-24 15:12:52 +08:00
CONTRIBUTING.md Update CLA link 2018-01-02 08:19:46 -08:00
LICENSE Update License file 2016-04-15 15:44:00 -07:00
MAINTAINERS Update security contacts 2019-07-10 10:48:31 -07:00
Makefile Separate make lint targets for developers vs travis (#4852) 2019-07-24 10:34:53 -07:00
OWNERS Update security contacts 2019-07-10 10:48:31 -07:00
README.md Updates to README.md and docs/drivers.md to document parallels vm-driver support 2019-07-12 18:18:47 -04:00
SECURITY_CONTACTS Update security contacts 2019-07-10 10:48:31 -07:00
code-of-conduct.md Update code-of-conduct.md 2017-12-20 13:39:35 -05:00
go.mod Upgrade libmachine to master 2019-07-19 13:52:35 +02:00
go.sum Upgrade libmachine to master 2019-07-19 13:52:35 +02:00
netlify.toml v0.55.0 rather than v0.55 2019-06-18 12:01:43 +08:00
test.sh Separate make lint targets for developers vs travis (#4852) 2019-07-24 10:34:53 -07:00

README.md

minikube

BuildStatus Widget GoReport Widget

What is minikube?

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

screenshot

minikube's primary goals are to be the best tool for local Kubernetes application development and to support all Kubernetes features that fit. We hope you enjoy it!

News

📣 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 👯

Features

minikube runs the latest 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

Help Wanted!

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

Access Kubernetes Dashboard within Minikube:

minikube dashboard

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