f34e34fa20
The find command errors on Mac. This uses "go list", which should be easier to maintain going forward. Also switch to one "go test" execution with many paths. This lets go test parallelize more effectively, and cuts the runtime down from 2.5m to 1.5m on my workstation. |
||
|---|---|---|
| Godeps | ||
| cmd | ||
| iso | ||
| pkg | ||
| test/integration | ||
| vendor | ||
| .cobra.yaml | ||
| .gitignore | ||
| .travis.yml | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| test.sh | ||
README.md
Minikube
Run Kubernetes locally
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
Requirements For Running Minikube
- VirtualBox installation
- VT-x/AMD-v virtualization must be enabled in BIOS
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