kubernetes
/
minikube
mirror of https://github.com/kubernetes/minikube.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
116 Commits
9 Branches
150 Tags
418 MiB
PostScript 50.6%
Go 27.8%
HTML 18%
Shell 1.9%
Makefile 0.8%
Other 0.7%
 
 
 
 
 
 
Go to file
dlorenc a9f97ec2dc Merge pull request #77 from dlorenc/master 
Fix make clean.
 		2016-05-14 10:43:29 -07:00
Godeps Blow away godeps.json, re "godep save". 2016-05-13 14:55:15 -07:00
cmd Working build, scp of localkube to the VM. 2016-05-12 10:12:34 -07:00
iso Build socat as part of the iso build. 2016-05-13 09:57:12 -07:00
pkg Blow away godeps.json, re "godep save". 2016-05-13 14:55:15 -07:00
test/integration Fix integration default path 2016-05-05 16:47:36 +03:00
vendor Blow away godeps.json, re "godep save". 2016-05-13 14:55:15 -07:00
.cobra.yaml Initial commit of CLI using cobra scaffolding. 2016-04-18 10:40:41 -07:00
.gitignore Remove unused files. 2016-05-14 09:58:44 -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 Fix make clean. 2016-05-14 10:27:58 -07:00
README.md Code review feedback. 2016-05-13 08:35:30 -07:00
test.sh Add .gopath and generated code to the whitelist for gofmt. 2016-05-13 10:24:39 -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 Requirements

  • A recent Go distribution (>1.6)
  • If you're not on Linux, you'll need a Docker installation

Build Instructions

make out/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