@@ -42,7 +42,7 @@ Here is a comparison for deploying a 10-node K8s cluster:
42
42
43
43
The sections below show examples of this.
44
44
45
- ## Using K8s.io KinD + Sysbox
45
+ ## Using K8s.io KinD + Sysbox (kind-sysbox)
46
46
47
47
<p align =" center " ><img alt =" sysbox " src =" ../figures/kind-sysbox.png " width =" 800x " /></p >
48
48
@@ -69,21 +69,22 @@ Unfortunately, you currently need a slightly modified version of the tool, as `k
69
69
does not yet formally support Sysbox. We will be working with the community to
70
70
add this support.
71
71
72
- In the meantime, we forked the KinD tool [ here] ( https://github.com/nestybox/kind )
73
- and made [ tiny changes] ( https://github.com/nestybox/kind/commit/9708a130b7c0a539f2f3b5aa187137e71f747347 )
74
- that enable it to work with Sysbox.
72
+ In the meantime, we forked the KinD tool [ here] ( https://github.com/nestybox/kind-sysbox )
73
+ and made [ tiny changes] ( https://github.com/nestybox/kind-sysbox/commit/9708a130b7c0a539f2f3b5aa187137e71f747347 )
74
+ that enable it to work with Sysbox. To avoid any confusion, we will refer to this modified
75
+ version as 'kind-sysbox'.
75
76
76
77
Here are the steps to use KinD + Sysbox:
77
78
78
79
1 ) Download and build the modified KinD binary:
79
80
80
81
``` console
81
- $ git clone https://github.com/nestybox/kind.git
82
- $ cd kind
83
- $ make kind
82
+ $ git clone https://github.com/nestybox/kind-sysbox .git
83
+ $ cd kind-sysbox
84
+ $ make kind-sysbox
84
85
```
85
86
86
- The resulting binary is under ` bin/kind ` . Put that in your PATH.
87
+ The resulting binary is under ` bin/kind-sysbox ` . Put that in your PATH.
87
88
88
89
2 ) Pull the ` nestybox/kindestnode:v1.18.2 ` image.
89
90
@@ -97,7 +98,7 @@ containers.
97
98
98
99
The Dockerfile is [ here] ( ../../dockerfiles/kindestnode ) .
99
100
100
- 3 ) Now simply tell ` kind ` to create the cluster.
101
+ 3 ) Now simply tell ` kind-sysbox ` to create the cluster.
101
102
102
103
``` console
103
104
$ more config.yaml
@@ -117,7 +118,7 @@ nodes:
117
118
```
118
119
119
120
``` console
120
- $ kind create cluster --image=nestybox/kindestnode:v1.18.2 --config=config.yaml
121
+ $ kind-sysbox create cluster --image=nestybox/kindestnode:v1.18.2 --config=config.yaml
121
122
122
123
Creating cluster "kind" ...
123
124
✓ Ensuring node image (nestybox/kindestnode:v1.18.2) 🖼
@@ -196,7 +197,7 @@ for a list of K8s functionality that works and doesn't when using Sysbox.
196
197
To bring down the cluster, use:
197
198
198
199
``` console
199
- $ kind delete cluster
200
+ $ kind-sysbox delete cluster
200
201
201
202
Deleting cluster "kind" ...
202
203
```
@@ -904,7 +905,7 @@ build process.
904
905
5 ) Now deploy the K8s cluster using the newly created image:
905
906
906
907
``` console
907
- $ kind create cluster --image kindestnode-with-inner-nginx
908
+ $ kind-sysbox create cluster --image kindestnode-with-inner-nginx
908
909
```
909
910
910
911
6 ) Verify the K8s cluster nodes have the inner nginx image in them:
@@ -980,7 +981,7 @@ $ docker stop k8s-node
980
981
5 ) Launch the K8s cluster with KinD + Sysbox, using the newly committed image:
981
982
982
983
``` console
983
- $ kind create cluster --image=kindestnode-with-inner-nginx:latest
984
+ $ kind-sysbox create cluster --image=kindestnode-with-inner-nginx:latest
984
985
```
985
986
986
987
6 ) Verify the K8s cluster nodes have the inner nginx image in them:
@@ -997,7 +998,7 @@ pod images into your K8s nodes.
997
998
998
999
One caveat however:
999
1000
1000
- Doing a Docker commit of a running K8s node deployed via ` kind create cluster `
1001
+ Doing a Docker commit of a running K8s node deployed via ` kind-sysbox create cluster `
1001
1002
won't work. The commit itself will complete, but the resulting image can't be
1002
1003
used in a new KinD cluster. The reason is that the committed image contains the
1003
1004
runtime configuration of the K8s node that is specific to the original cluster,
0 commit comments