4ff23d96430fa713e0f8af76e0cad66df49f051b
[webi-installers/.git] / kind / README.md
1 ---
2 title: kind
3 homepage: https://github.com/kubernetes-sigs/kind
4 tagline: |
5   kind: tool for running local Kubernetes clusters using Docker container "nodes".
6 ---
7
8 To update or switch versions, run `webi kind@stable` (or `@v2`, `@beta`,etc).
9
10 ## Cheat Sheet
11
12 > Kind uses a single docker container to run a lightweight kubernetes cluster for testing and shenanigans
13
14 User Guide - Quick Start: https://kind.sigs.k8s.io/docs/user/quick-start
15
16 To create a cluster with default name
17 ```bash
18 kind create cluster
19 ```
20
21 Create a cluster with a specific name
22 ```bash
23 kind create cluster --name foo
24 ```
25
26 List clusters
27 ```bash
28 kind get clusters
29 ```
30
31 Specify Kubernetes version
32 ```bash
33 kind create cluster --image "kindest/node:$favoriteTag"
34 ```
35 - pick your $favoriteTag from here: https://hub.docker.com/r/kindest/node/tags?page=1&ordering=last_updated
36
37 Export all logs from a cluster
38 ```bash
39 kind exports logs $HOME/somedir
40 ```
41
42 To delete a cluster with default name
43 ```bash
44 kind delete cluster
45 ```
46
47 To delete a cluster with specific name
48 ```bash
49 kind delete cluster --name foo
50 ```
51
52 Get the kubeconfig of a cluster
53 ```bash
54 kind get kubeconfig --name foo
55 ```