docs: add a guide for IPv6-only kind clusters - #19
Open
ygao-g wants to merge 1 commit into
Open
Conversation
ygao-g
force-pushed
the
docs-ipv6-local
branch
3 times, most recently
from
September 3, 2026 20:22
e7f9827 to
f42f322
Compare
ygao-g
force-pushed
the
kind-ipv6-coredns
branch
from
September 3, 2026 20:22
3d8fa87 to
a447f37
Compare
IP_FAMILY=ipv6 has no documentation, so the two things that reliably go wrong get rediscovered every time: a Docker daemon with IPv6 off, and a host that cannot route IPv6 at all. The second is usually measured with `curl -6 <host>`, which cannot tell a resolver returning no AAAA apart from a host with no route, and reports neither. Also covers the kubeconfig rewrite kubectl needs when the cluster runs in a Lima VM on macOS, where kind publishes the apiserver on [::1] and Lima forwards that port to the host's 127.0.0.1.
ygao-g
force-pushed
the
docs-ipv6-local
branch
from
September 3, 2026 20:26
f42f322 to
4e57878
Compare
ygao-g
force-pushed
the
kind-ipv6-coredns
branch
from
September 3, 2026 20:26
a447f37 to
6c9d0ce
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents
IP_FAMILY=ipv6, which has no docs today. Covers the Docker daemonprerequisite, how to tell whether the host can route IPv6 without confusing
that with DNS, and the kubeconfig rewrite
kubectlneeds against a clusterrunning in a Lima VM.
Split out of agent-substrate#1275 so the NAT64 half can be reviewed
on its own; this half describes only what the flag already does.
Based on agent-substrate#958 — without it an IPv6-only cluster's pods
resolve nothing, so the opening claim here is not true until that merges. The
base branch is
kind-ipv6-corednsfor that reason, and the diff is the new docplus one
CONTRIBUTING.mdlink.Part of agent-substrate#246.
🤖 Generated with Claude Code