kubernetes
/
minikube
mirror of https://github.com/kubernetes/minikube.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
70 Commits
14 Branches
150 Tags
413 MiB
PostScript 50.6%
Go 27.8%
HTML 18%
Shell 1.9%
Makefile 0.8%
Other 0.7%
 
 
 
 
 
 
Go to file
Dan Lorenc 4f712bf3be Make localkube serve securely. 2016-05-06 16:05:42 -07:00
Godeps added localkube and dependencies 2016-05-04 01:54:00 -07:00
cli Move script to it's own file. 2016-05-06 16:05:42 -07:00
cmd Add a flag for controlling the localkube binary location. 2016-05-06 16:05:42 -07:00
pkg Make localkube serve securely. 2016-05-06 16:05:42 -07:00
test/integration Fix integration default path 2016-05-05 16:47:36 +03:00
vendor added localkube and dependencies 2016-05-04 01:54:00 -07:00
.cobra.yaml Initial commit of CLI using cobra scaffolding. 2016-04-18 10:40:41 -07:00
.gitignore Update .gitignore and integration test for new build locations. 2016-05-04 14:31:32 -07:00
.travis.yml Add a Makefile to replace build.sh and test.sh. 2016-05-04 14:45:06 -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
Makefile Restructure the whole project, gofmt and improve the makefile 2016-05-05 16:38:23 +03:00
README.md Add a Makefile to replace build.sh and test.sh. 2016-05-04 14:45:06 -07:00
godep.sh updated .gitignore and added comment explaining vendoring patch 2016-05-04 02:24:07 -07:00
test.sh Code review comments 2016-05-04 15:29:50 -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

make minikube

Run Instructions

Start the cluster with:

$ ./out/minikube 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 by adding -s=http://192.168.x.x:8080 to every kubectl command, or run the commands below:

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

by running those commands, you may use kubectl normally

Development

See CONTRIBUTING.md for an overview of how to send pull requests.

Running Tests

Unit Tests

Unit tests are run on Travis before code is merged. To run as part of a development cycle:

make test

Integration Tests

Integration tests are currently run manually. To run them, build the binary and run the tests:

make integration