Why is this kind configuration file broken and where do I get kind versions

Question

I am trying to follow this tutorial to learn to use kind. The version I just installed using brew install is: kind version 0.11.1

The config file looks like this:

kind: Cluster
apiVersion: kind.sigs.k8s.io/v1alpha3
nodes:
- role: control-plane
  extraPortMappings:
  - containerPort: 30080
    hostPort: 80
    listenAddress: "0.0.0.0"
    protocol: TCP

Apparently that version is wrong because I get an error ERROR: failed to create cluster: unknown apiVersion: kind.sigs.k8s.io/v1alpha3 when I try to create the cluster: $ kind create cluster --name mycluster --config config/kind.config.yaml --wait 5m.

I found an example of some other version string, but when trying to add the spec block in that same tutorial I get a configuration error. I assume this means because the API broke between the version and the yaml I am using.

Why do I get the original "failed to create cluster" error, and where can I find documentation associating kind versions with yaml syntax?

Answer 1

The version needs to be set to apiVersion: kind.x-k8s.io/v1alpha4

Notice the change from kind.sigs.k8s.io to kind.x-k8s.io in addition to changing to v1alpha4.