kind is a tool for running local Kubernetes clusters using Docker container “nodes”.
kind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.
kind consists of:
NOTE: kind is still a work in progress, see the 1.0 roadmap.
Installation and usage 🔗︎
For more detailed instructions see the user guide.
You can install kind with
go get sigs.k8s.io/kind. This will put
$(go env GOPATH)/bin. You may need to add that directory to your
$PATH as shown here if you encounter the error
kind: command not found after installation.
To use kind, you will also need to install docker.
Once you have docker running you can create a cluster with:
To delete your cluster use:
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
Multi-node clusters and other advanced features may be configured with a config file, for more usage see the user guide or run
kind [command] --help
Please reach out for bugs, feature requests, and other issues!
The maintainers of this project are reachable via:
Pull Requests are very welcome!
If you’re planning a new feature, please file an issue to discuss first.
Check the issue tracker for
help wanted issues if you’re unsure where to start, or feel free to reach out to discuss. 🙂
- kind supports multi-node (including HA) clusters
- kind supports building Kubernetes release builds from source
- support for make / bash / docker, or bazel, in addition to pre-published builds
- kind supports Linux, macOS and Windows
- kind is a CNCF certified conformant Kubernetes installer
Code of conduct 🔗︎
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.