Skip to content

hack: make the kind cluster's IP family configurable - #877

Open
Yuan Gao (ygao-g) wants to merge 1 commit into
agent-substrate:mainfrom
ygao-g:kind-ip-family-core
Open

hack: make the kind cluster's IP family configurable#877
Yuan Gao (ygao-g) wants to merge 1 commit into
agent-substrate:mainfrom
ygao-g:kind-ip-family-core

Conversation

@ygao-g

@ygao-g Yuan Gao (ygao-g) commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Fixes #845

IP_FAMILY selects ipv4, dual, or ipv6 and passes this through to kind. To prevent insidious failures like pods stuck in ContainerCreating, the script now drops old Docker networks to force IPv6 recreation if needed, validates the daemon's IPv6 support up-front, and enables proxy_ndp (alongside proxy_arp) to properly support gVisor loopback pod-to-pod networking across IPv6 nodes.

Tested on kind with all three families: node InternalIPs, Service ClusterIPs and pod IPs land in the requested families, pod-to-pod and CoreDNS work on them, and pods still pull through the local registry.

@ygao-g

Copy link
Copy Markdown
Contributor Author

Comment thread hack/create-kind-cluster.sh Outdated
Comment thread hack/verify-kind-networking.sh Outdated
IP_FAMILY selects ipv4, ipv6 or dual and becomes networking.ipFamily, leaving
kind's per-family subnet defaults alone. The script also recreates a pre-IPv6
"kind" Docker network, fails fast if the daemon has IPv6 off, sets proxy_ndp
alongside proxy_arp for gVisor pod-to-pod traffic, and repoints an ipv6
kubeconfig from [::1] at localhost so a client outside the Docker host can
still reach the apiserver.

Tested on kind with all three families: node InternalIPs, Service ClusterIPs
and pod IPs land in the requested families, pod-to-pod and CoreDNS work on
them, and pods still pull through the local registry.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

hack: create-kind-cluster.sh cannot make a dual-stack or IPv6-only cluster

2 participants