Run cluster with all-in-one image #

This document walks through the steps to create a cluster with the all-in-one image.

Getting started #

docker run --rm -it -p 8080:8080 registry.k8s.io/kwok/cluster:v0.4.0-k8s.v1.28.0

Quick Verification #

You can use the kubectl with the -s option to connect to the cluster.

kubectl -s :8080 get ns

NAME              STATUS   AGE
default           Active   1s
kube-node-lease   Active   1s
kube-public       Active   1s
kube-system       Active   1s

Setting up kubeconfig #

You can set up the kubeconfig file to connect to the cluster.

apiVersion: v1
clusters:
- cluster:
    server: http://127.0.0.1:8080
  name: kwok
contexts:
- context:
    cluster: kwok
  name: kwok
current-context: kwok
kind: Config
preferences: {}
users: null

Use in a pod #

If you are using the all-in-one image in a pod, you need disable the service account token or the cluster might not work properly.

...
spec:
  automountServiceAccountToken: false
...

or

remove the service account token file /var/run/secrets/kubernetes.io/serviceaccount/token.

Next steps #

Now, you can use kwok to manage nodes and pods in the Kubernetes cluster.