Go to file
dlorenc 482cc7626a Merge pull request #23 from dlorenc/master
Exit with a non-zero code if we error.
2016-04-25 15:57:14 -07:00
Godeps Cleanup unused godeps after removing localkubectl dependency. 2016-04-25 13:57:17 -07:00
cli Add a test for the root command, including driver initialization. 2016-04-25 15:55:43 -07:00
vendor Cleanup unused godeps after removing localkubectl dependency. 2016-04-25 13:57:17 -07:00
.cobra.yaml Initial commit of CLI using cobra scaffolding. 2016-04-18 10:40:41 -07:00
.gitignore Initial commit of CLI using cobra scaffolding. 2016-04-18 10:40:41 -07:00
.travis.yml Add .travis.yml. 2016-04-25 10:25:44 -07:00
CONTRIBUTING.md Add CONTRIBUTING.md 2016-04-25 10:42:07 -07:00
LICENSE Update License file 2016-04-15 15:44:00 -07:00
README.md Add travis badge to README.md 2016-04-25 10:29:07 -07:00

README.md

Minikube

Run Kubernetes locally

Build Status

Background

Minikube is a tool that makes it easy to run Kubernetes locally. Minikube runs a single-node Kubernetes cluster inside a VM on your laptop for users looking to try out Kubernetes or develop with it day-to-day.

Design

Minikube uses libmachine for provisioning VMs, and localkube for running the cluster.

For more information about minikube, see the proposal.

Goals

  • Works across multiple OSes - OS X, Linux and Windows primarily.
  • Single command setup and teardown UX.
  • Unified UX across OSes
  • Minimal dependencies on third party software.
  • Minimal resource overhead.
  • Replace any other alternatives to local cluster deployment.

Non Goals

  • Simplifying kubernetes production deployment experience. Kube-deploy is attempting to tackle this problem.
  • Supporting all possible deployment configurations of Kubernetes like various types of storage, networking, etc.

Build Instructions

go build cli/main.go

Run Instructions

Start the cluster with:

./main start
Starting local Kubernetes cluster...
2016/04/19 11:41:26 Machine exists!
2016/04/19 11:41:27 Kubernetes is available at http://192.168.99.100:8080.
2016/04/19 11:41:27 Run this command to use the cluster: 
2016/04/19 11:41:27 kubectl config set-cluster minikube --insecure-skip-tls-verify=true --server=http://192.168.99.100:8080

Access the cluster with:

First run the command from above:

kubectl config set-cluster minikube --insecure-skip-tls-verify=true --server=http://192.168.99.100:8080

Then use kubectl normally:

kubectl get pods --cluster=minikube