{"id":13416673,"url":"https://github.com/kubernetes-sigs/kind","last_synced_at":"2025-05-12T15:29:14.093Z","repository":{"id":37270396,"uuid":"148545807","full_name":"kubernetes-sigs/kind","owner":"kubernetes-sigs","description":"Kubernetes IN Docker - local clusters for testing Kubernetes","archived":false,"fork":false,"pushed_at":"2025-05-05T21:30:50.000Z","size":13469,"stargazers_count":14109,"open_issues_count":196,"forks_count":1613,"subscribers_count":140,"default_branch":"main","last_synced_at":"2025-05-05T22:35:31.095Z","etag":null,"topics":["docker","golang","k8s-sig-testing","kubeadm","kubernetes","podman"],"latest_commit_sha":null,"homepage":"https://kind.sigs.k8s.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kubernetes-sigs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_CONTACTS","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-09-12T21:45:05.000Z","updated_at":"2025-05-05T21:30:56.000Z","dependencies_parsed_at":"2023-10-26T19:35:27.665Z","dependency_job_id":"c1f6583e-dbd8-454b-8cec-5cf6491a9800","html_url":"https://github.com/kubernetes-sigs/kind","commit_stats":{"total_commits":2833,"total_committers":337,"mean_commits":8.40652818991098,"dds":"0.35968937522061417","last_synced_commit":"68590c1c3f4143005d20dd230c32143a4be5a072"},"previous_names":[],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes-sigs","download_url":"https://codeload.github.com/kubernetes-sigs/kind/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253765447,"owners_count":21960730,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","golang","k8s-sig-testing","kubeadm","kubernetes","podman"],"created_at":"2024-07-30T22:00:19.312Z","updated_at":"2025-05-12T15:29:14.067Z","avatar_url":"https://github.com/kubernetes-sigs.png","language":"Go","funding_links":[],"categories":["Popular","Go","Kubernetes","Software Packages","Tools and Libraries","HarmonyOS","Containers","golang","Cluster Provisioning \u0026 Lifecycle","K8S-Tools","kubernetes","Go Tools","Shell","软件包","一、核心工具集（按场景分类）"],"sub_categories":["Distributions","DevOps Tools","Cluster Provisioning","Windows Manager","Kubernetes","Editors","DevOps 工具","2. 集群部署工具（快速搭环境）"],"readme":"\u003cp align=\"center\"\u003e\u003cimg alt=\"kind\" src=\"./logo/logo.png\" width=\"300px\" /\u003e\u003c/p\u003e\n\n# Please see [Our Documentation](https://kind.sigs.k8s.io/docs/user/quick-start/) for more in-depth installation etc.\n\nkind is a tool for running local Kubernetes clusters using Docker container \"nodes\".\nkind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.\n\nIf you have [go] 1.16+ and [docker], [podman] or [nerdctl] installed `go install sigs.k8s.io/kind@v0.27.0 \u0026\u0026 kind create cluster` is all you need!\n\n![](site/static/images/kind-create-cluster.png)\n\nkind consists of:\n- Go [packages][packages] implementing [cluster creation][cluster package], [image build][build package], etc.\n- A command line interface ([`kind`][kind cli]) built on these packages.\n- Docker [image(s)][images] written to run systemd, Kubernetes, etc.\n- [`kubetest`][kubetest] integration also built on these packages (WIP)\n\nkind bootstraps each \"node\" with [kubeadm][kubeadm]. For more details see [the design documentation][design doc].\n\n**NOTE**: kind is still a work in progress, see the [1.0 roadmap].\n\n## Installation and usage\n\nFor a complete [install guide] see [the documentation here][install guide].\n\nYou can install kind with `go install sigs.k8s.io/kind@v0.27.0`.\n\n**NOTE**: please use the latest go to do this. KIND is developed with the latest stable go, see [`.go-version`](./.go-version) for the exact version we're using.\n\nThis will put `kind` in `$(go env GOPATH)/bin`. If you encounter the error\n`kind: command not found` after installation then you may need to either add that directory to your `$PATH` as\nshown [here](https://golang.org/doc/code.html#GOPATH) or do a manual installation by cloning the repo and run\n`make build` from the repository.\n\nWithout installing go, kind can be built reproducibly with docker using `make build`.\n\nStable binaries are also available on the [releases] page. Stable releases are\ngenerally recommended for CI usage in particular.\nTo install, download the binary for your platform from \"Assets\" and place this\ninto your `$PATH`:\n\nOn Linux:\n\n```console\n# For AMD64 / x86_64\n[ $(uname -m) = x86_64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.27.0/kind-$(uname)-amd64\n# For ARM64\n[ $(uname -m) = aarch64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.27.0/kind-$(uname)-arm64\nchmod +x ./kind\nsudo mv ./kind /usr/local/bin/kind\n```\n\nOn macOS via Homebrew:\n\n```console\nbrew install kind\n```\n\nOn macOS via MacPorts:\n\n```console\nsudo port selfupdate \u0026\u0026 sudo port install kind\n```\n\nOn macOS via Bash:\n\n```console\n# For Intel Macs\n[ $(uname -m) = x86_64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.27.0/kind-darwin-amd64\n# For M1 / ARM Macs\n[ $(uname -m) = arm64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.27.0/kind-darwin-arm64\nchmod +x ./kind\nmv ./kind /some-dir-in-your-PATH/kind\n```\n\nOn Windows:\n\n```powershell\ncurl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.27.0/kind-windows-amd64\nMove-Item .\\kind-windows-amd64.exe c:\\some-dir-in-your-PATH\\kind.exe\n\n# OR via Chocolatey (https://chocolatey.org/packages/kind)\nchoco install kind\n```\n\nTo use kind, you will need to [install docker].\nOnce you have docker running you can create a cluster with:\n\n```console\nkind create cluster\n```\n\nTo delete your cluster use:\n\n```console\nkind delete cluster\n```\n\n\u003c!--TODO(bentheelder): improve this part of the guide--\u003e\nTo create a cluster from Kubernetes source:\n- ensure that Kubernetes is cloned in `$(go env GOPATH)/src/k8s.io/kubernetes`\n- build a node image and create a cluster with:\n```console\nkind build node-image\nkind create cluster --image kindest/node:latest\n```\n\nMulti-node clusters and other advanced features may be configured with a config\nfile, for more usage see [the docs][user guide] or run `kind [command] --help`\n\n## Community\n\nPlease reach out for bugs, feature requests, and other issues!\nThe maintainers of this project are reachable via:\n\n- [Kubernetes Slack] in the [#kind] channel\n- [filing an issue] against this repo\n- The Kubernetes [SIG-Testing Mailing List]\n\nCurrent maintainers are [@aojea], [@BenTheElder], and [@stmcginnis] - feel free to\nreach out if you have any questions!\n\nPull Requests are very welcome!\nIf you're planning a new feature, please file an issue to discuss first.\n\nCheck the [issue tracker] for `help wanted` issues if you're unsure where to\nstart, or feel free to reach out to discuss. 🙂\n\nSee also: our own [contributor guide] and the Kubernetes [community page].\n\n## Why kind?\n\n- kind supports multi-node (including HA) clusters\n- kind supports building Kubernetes release builds from source\n  - support for make / bash or docker, in addition to pre-published builds\n- kind supports Linux, macOS and Windows\n- kind is a [CNCF certified conformant Kubernetes installer](https://landscape.cncf.io/?selected=kind)\n\n### Code of conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct].\n\n\u003c!--links--\u003e\n[go]: https://golang.org/\n[go-supported]: https://golang.org/doc/devel/release.html#policy\n[docker]: https://www.docker.com/\n[podman]: https://podman.io/\n[nerdctl]: https://github.com/containerd/nerdctl\n[community page]: https://kubernetes.io/community/\n[Kubernetes Code of Conduct]: code-of-conduct.md\n[Go Report Card Badge]: https://goreportcard.com/badge/sigs.k8s.io/kind\n[Go Report Card]: https://goreportcard.com/report/sigs.k8s.io/kind\n[conformance tests]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/conformance-tests.md\n[packages]: ./pkg\n[cluster package]: ./pkg/cluster\n[build package]: ./pkg/build\n[kind cli]: ./main.go\n[images]: ./images\n[kubetest]: https://github.com/kubernetes/test-infra/tree/master/kubetest\n[kubeadm]: https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm/\n[design doc]: https://kind.sigs.k8s.io/docs/design/initial\n[user guide]: https://kind.sigs.k8s.io/docs/user/quick-start\n[SIG-Testing Mailing List]: https://groups.google.com/forum/#!forum/kubernetes-sig-testing\n[issue tracker]: https://github.com/kubernetes-sigs/kind/issues\n[filing an issue]: https://github.com/kubernetes-sigs/kind/issues/new\n[Kubernetes Slack]: http://slack.k8s.io/\n[#kind]: https://kubernetes.slack.com/messages/CEKK1KTN2/\n[1.0 roadmap]: https://kind.sigs.k8s.io/docs/contributing/1.0-roadmap\n[install docker]: https://docs.docker.com/install/\n[@BenTheElder]: https://github.com/BenTheElder\n[@munnerz]: https://github.com/munnerz\n[@aojea]: https://github.com/aojea\n[@amwat]: https://github.com/amwat\n[@stmcginnis]: https://github.com/stmcginnis\n[contributor guide]: https://kind.sigs.k8s.io/docs/contributing/getting-started\n[releases]: https://github.com/kubernetes-sigs/kind/releases\n[install guide]: https://kind.sigs.k8s.io/docs/user/quick-start/#installation\n[modules]: https://github.com/golang/go/wiki/Modules\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fkind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes-sigs%2Fkind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fkind/lists"}