kubernetes-sigs /kind
Kubernetes IN Docker - local clusters for testing Kubernetes
★ 15,617⑂ 1,834👁 142⑃ 2,212● 2,066▤ 39
-1
日增长
15,617
stars
1,834
forks
142
watchers
2,212
prs
2,066
issues
39
releases
README
Please see Our Documentation for more in-depth installation etc. 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. If you have [go] and [docker], [podman] or [nerdctl] installed go install sigs.k8s.io/[email protected] && kind create cluster is all you need! ! kind consists of: - Go [packages][packages] implementing [cluster creation][cluster package], [image build][build package], etc. - A command line interface ([kind][kind cli]) built on these packages. - Docker [image(s)][images] written to run systemd, Kubernetes, etc. - [kubetest][kubetest] integration also built on these packages (WIP) kind bootstraps each "node" with [kubeadm][kubeadm]. For more details see [the design documentation][design doc]. NOTE: kind is still a work in progress, see the [1.0 roadmap]. Installation and usage For a complete [install guide] see [the documentation here][install guide]. You can install kind with go install sigs.k8s.io/[email protected]. NOTE: please use the latest go to do this. KIND is developed with the latest stable go, see .go-version for the exact version we're using. This will put kind in $(go env GOPATH)/bin. If you encounter the error kind: command not found after installation then you may need to either add that directory to your $PATH as shown here or do a manual installation by cloning the repo and run make build from the repository. Without installing go, kind can be built reproducibly with docker using make build. 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 $PATH: On Linux: console For AMD64 / x86_64 [ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-$(uname)-amd64 For ARM64 [ $(uname -m) = aarch64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-$(uname)-arm64 chmod +x ./kind sudo mv ./kind /usr/local/bin/kind On macOS via Homebrew: console brew install kind On macOS via MacPorts: console sudo port selfupdate && sudo port install kind On macOS via Bash: console For Intel Macs [ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-darwin-amd64 For M1 / ARM Macs [ $(uname -m) = arm64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-darwin-arm64 chmod +x ./kind mv ./kind /some-dir-in-your-PATH/kind On Windows: powershell curl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.33.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: console kind create cluster To delete your cluster use: cons
Top issues
#3795Unable to load docker containerd managed images to cluster69 comments · 2024-11-20#303document how to run kind in a kubernetes pod53 comments · 2019-02-15#1689HA clusters don't reboot properly40 comments · 2020-06-25#1213Better UX for using local registry38 comments · 2019-12-30#1487Enable Simulation of automatically provisioned ReadWriteMany PVs33 comments · 2020-04-17#2867when running kind in a container with the docker socket mounted: kind create cluster fails to remove control plane taint32 comments · 2022-08-08#2718DOCKER_DEFAULT_PLATFORM breaks kind if it does not match the dockerd host platform31 comments · 2022-04-15#3164Support GPUs30 comments · 2023-04-11
Latest release
v0.33.0 v0.33.0 2026-08-26This release contains critical dependency updates, bug fixes, and defaults to Kubernetes 1.37.0. Breaking Changes The default node image is now kindest/node:v1.37.0@sha256:a1ed56cfb0e7b93589bdf97c8cd566405a265939e3620fc4f5de89adff580ae5. New Features Assorted dependency updates. Images pre-built for this release: v1.37.0: kindest/node:v1.37.0@sha256:a1ed56cfb0e7b93589bdf97c8cd566405a265939e3620fc4f5de89adff580ae5 v1.36.4: kindest/node:v1.36.4@sha256:099e049362a1526b2db71494e1947aae99bd16290d7c895f2b7ea312e3cbfaed v1.35.8: kindest/node:v1.35.8@sha256:07b2536e30b803ed6