kind is a tool for running local Kubernetes clusters using Docker container "nodes".
kind is primarily designed for testing Kubernetes 1.11+, initially targeting the conformance tests.
kind consists of:
- Go packages implementing cluster creation, image build, etc.
- A command line interface (
kind) built on these packages.
- Docker image(s) written to run systemd, Kubernetes, etc.
kubetestintegration also built on these packages (WIP)
kind is still a work in progress, see docs/todo.md.
Installation and usage
You can install
go get sigs.k8s.io/kind
kind, you will need to install docker.
Once you have docker running you can create a cluster with
kind create cluster
To delete your cluster use
kind delete cluster
To create a cluster from Kubernetes source:
- ensure that Kubernetes is cloned in
$(go env GOPATH)/src/k8s.io/kubernetes
- build a node image and create a cluster with
kind build node-image && kind create cluster
For more usage see the docs or run
kind [command] --help
Community, discussion, contribution, and support
Please reach out for bugs, feature requests, and other issues!
The maintainers of this project are reachable via:
- Kubernetes Slack in the #sig-testing channel
- filing an issue against this repo
- The Kubernetes SIG-Testing Mailing List
Pull Requests are very welcome!
See the issue tracker if you're unsure where to start, or feel free to reach out to discuss.
See also: the Kubernetes community page.
Code of conduct
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.