[docs] Mismatched guidance on local development; kind vs minikube

[jdheyburn]

Hey there,
I've tried to tackle this feature as starter contribution.

I would like to point out that the devcontainer bundled with the project cannot be used "as is", because the default image for golang:1.24 is now based on debian trixie and moby has been removed.

This is the error I got while building the devcontainer:

0.168 (!) The 'moby' option is not supported on Debian 'trixie' because 'moby-cli' and related system packages have been removed from that distribution. 
0.168 (!) To continue, either set the feature option '"mob [2026-01-04T13:20:29.860Z] y": false' or use a different base image (for example: 'debian:bookworm' or 'ubuntu-24.04'). 
0.168 ERROR: Feature "Docker (Docker-in-Docker)" (ghcr.io/devcontainers/features/docker-in-docker) failed to install! Look at the documentation at https://github.com/devcontainers/features/tree/main/src/docker-in-docker for help troubleshooting this error.

A simple fix woud be to pin the base image to golang:1.24-bookworm.

To streamline the onboarding procedure maybe you can consider using only one local kuberenets solution: currently kind is used in the makefile and minikube is suggested in the contributing guide.

Originally posted by @riccardoforzan in #32

I would suggest validating the issue to see if it can be replicated.

[hashrr]

I am trying to setup things for contributing. I will validate this in the process.😊

[sandeepkunusoth]

ip route step doesn't work for me on mac while setting up minikube. i use kind for local deveopment.

[utdrmac]

I just started using kind last week, and it is pretty cool. Super easy to setup, and all my existing tools think it is a full K8S. A word of caution though: etcd is very IO intensive. Sitting idle, my server was showing loads upwards of 7 to 9, and the RAID array holding all my docker containers was very busy. As soon as I deleted my kind cluster, loads went back down to < 0.5.
I created a 1G tmpfs (ram disk) and mounted it for etcd. Loads are "normal" now.

$ mkdir /tmp/etcd
$ mount -t tmpfs -o size=1G /tmp/etcd

$ cat ~/5-node-kind-cluster.yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
  extraMounts:
  - containerPath: /var/lib/etcd
    hostPath: /tmp/etcd
- role: worker
- role: worker
- role: worker
- role: worker
- role: worker

[sandeepkunusoth]

kubebuilder fixed this by setting moby=false instead.
kubernetes-sigs/kubebuilder#5266 (comment)

#71 (comment)