2018-07-23 10:06:37 -07:00
|
|
|
# kind - (**K**ubernetes **IN** **D**ocker)
|
2018-09-12 14:44:29 -07:00
|
|
|
|
2018-07-23 10:06:37 -07:00
|
|
|
## WARNING: kind is still a work in progress!
|
|
|
|
|
|
|
|
|
|
`kind` is a toolset for running local Kubernetes clusters using Docker container "nodes".
|
|
|
|
|
|
|
|
|
|
It consists of:
|
|
|
|
|
- Go [packages](./pkg) implementing cluster creation, image build, etc.
|
|
|
|
|
- A command line interface ([`kind`](./cmd/kind)) built on these packages
|
|
|
|
|
- [`kubetest`](https://github.com/kubernetes/test-infra/tree/master/kubetest) integration also built on these packages (WIP)
|
|
|
|
|
|
|
|
|
|
Kind bootstraps each "node" with [kubeadm](https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm/).
|
|
|
|
|
|
|
|
|
|
For more details see [the design documentation](./docs/design.md).
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
`kind create` will create a cluster
|
|
|
|
|
|
|
|
|
|
`kind delete` will delete a cluster
|
|
|
|
|
|
|
|
|
|
## Advanced
|
|
|
|
|
|
|
|
|
|
`kind build image --source=./kind/images/node` will build the node image
|
2018-09-12 14:44:29 -07:00
|
|
|
|
|
|
|
|
## Community, discussion, contribution, and support
|
|
|
|
|
|
|
|
|
|
Learn how to engage with the Kubernetes community on the [community page](http://kubernetes.io/community/).
|
|
|
|
|
|
|
|
|
|
You can reach the maintainers of this project at:
|
|
|
|
|
|
|
|
|
|
- [Slack](http://slack.k8s.io/)
|
|
|
|
|
- [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-dev)
|
|
|
|
|
|
|
|
|
|
### Code of conduct
|
|
|
|
|
|
|
|
|
|
Participation in the Kubernetes community is governed by the [Kubernetes Code of Conduct](code-of-conduct.md).
|
|
|
|
|
|
|
|
|
|
[owners]: https://git.k8s.io/community/contributors/guide/owners.md
|
