Skip to content

Run actors on IPv6-only and dual-stack clusters - #185

Open
steigr wants to merge 1 commit into
kagent-dev:mainfrom
steigr:ipv6/actor-networking
Open

steigr wants to merge 1 commit into
kagent-dev:mainfrom
steigr:ipv6/actor-networking

Conversation

@steigr

@steigr steigr commented Nov 19, 2026

Copy link
Copy Markdown

Actors only get the IPv4 link-local /30, so they cannot run on an IPv6-only
cluster, and on a dual-stack cluster they have no IPv6 egress.

The actor sandbox now follows the worker pod's IP families: IPv4
169.254.17.0/30, IPv6 fd00:a7e:17::/126, or both. Each family gets its own
nftables table, /etc/hosts entry and wakeup probe address. A dial to a family
the sandbox lacks fails with ENETUNREACH. Both the gVisor and microVM workers
pass the families to actornet.

The diff is about 1,240 lines, 60% of them tests. Every part depends on the
new actornet.Families API or on actors having IPv6, so it is one commit.

Part of IPv6 support: #182

Known gaps:

  • microVM snapshots do not record the families they were taken with.
  • An IPv6-only cluster cannot pull from IPv4-only registries such as quay.io,
    where the Jupyter demo image lives.

Testing: unit tests, including the root-gated ones. The full e2e suite on kind
in a Lima VM on arm64 macOS, for ipv4, ipv6 and dual, on gVisor and microVM,
with both the Envoy and agentgateway dataplanes. The IPv6-only runs also
needed the listener and kind DNS PRs, and the agentgateway runs the egress
authority PR. Some microVM tests timed out under nested-virt load at
parallelism 4 and passed when rerun at parallelism 2.

AI use: I used Claude Code to write the code and tests and to run the tests
above. I reviewed every change and can explain it.

  • Tests pass
  • Docs updated

Actors only got the IPv4 /30, so an IPv6-only cluster could not run them
and a dual-stack one gave them no IPv6 egress. The sandbox now follows
the worker pod's IP families: IPv4 169.254.17.0/30, IPv6
fd00:a7e:17::/126, or both. Each family gets its own nftables table,
/etc/hosts entry and wakeup probe address. Dialing a family the sandbox
lacks fails with ENETUNREACH.

Both workers pass the families to actornet, and the e2e tests no longer
assume IPv4 addresses.

Signed-off-by: steigr <me@stei.gr>
@steigr
steigr force-pushed the ipv6/actor-networking branch from 1956199 to a04f789 Compare November 19, 2026 11:28
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.

1 participant