Kubernetes IN Docker - local clusters for testing Kubernetes
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.
GO111MODULE="on" go get sigs.k8s.io/[email protected] && kind create clusteris all you need!
image(s) written to run systemd, Kubernetes, etc. -
kubetestintegration also built on these packages (WIP)
NOTE: kind is still a work in progress, see the 1.0 roadmap.
You can install kind with
GO111MODULE="on" go get sigs.k8s.io/[email protected].
NOTE: please use the latest go to do this, ideally go 1.13 or greater.
go getshould not be run from a Go [modules] enabled project directory, as go get inside a modules enabled project updates dependencies / behaves differently. Try for example
This will put
$(go env GOPATH)/bin. If you encounter the error
kind: command not foundafter installation then you may need to either add that directory to your
$PATHas shown here or do a manual installation by cloning the repo and run
make buildfrom the repository.
Without installing go, kind can be built reproducibly with docker using
Stable binaries are also available on the releases page. Stable releases are generally recommended for CI usage in particular. To install, download the binary for your platform from "Assets" and place this into your
On Mac & Linux:
curl -Lo ./kind "https://kind.sigs.k8s.io/dl/v0.10.0/kind-$(uname)-amd64" chmod +x ./kind mv ./kind /some-dir-in-your-PATH/kind
On Mac via Homebrew:
brew install kind
curl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.10.0/kind-windows-amd64 Move-Item .\kind-windows-amd64.exe c:\some-dir-in-your-PATH\kind.exe
OR via Chocolatey (https://chocolatey.org/packages/kind)
choco install kind
To use 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:
console kind build node-image kind create cluster --image kindest/node:latest
Multi-node clusters and other advanced features may be configured with a config file, for more usage see the docs 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 wantedissues if you're unsure where to start, or feel free to reach out to discuss. 🙂
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.