Skip to content

atenet/dns: answer non-A actor queries instead of SERVFAIL - #874

Open
Yuan Gao (ygao-g) wants to merge 1 commit into
agent-substrate:mainfrom
ygao-g:atenet-dns-rcode
Open

atenet/dns: answer non-A actor queries instead of SERVFAIL#874
Yuan Gao (ygao-g) wants to merge 1 commit into
agent-substrate:mainfrom
ygao-g:atenet-dns-rcode

Conversation

@ygao-g

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

Copy link
Copy Markdown
Collaborator

Fixes #888

The actor DNS zone only answered A; everything else — AAAA for a valid
actor, and any other name in the zone — got SERVFAIL. Strict resolvers treat
that as a hard network error rather than an empty answer, and musl maps it to
EAI_AGAIN, sinking the paired A query with it, so Alpine actors could not
resolve each other even on an IPv4-only cluster.

Valid actor names now return NODATA (NOERROR + SOA) for non-A types, and
anything else in the zone returns NXDOMAIN — both negatively cacheable. This
does not publish an AAAA record; that is #938.

@ygao-g
Yuan Gao (ygao-g) marked this pull request as draft August 11, 2026 23:12
Comment thread cmd/atenet/internal/dns/corefile.go
@ygao-g

Copy link
Copy Markdown
Collaborator Author

Bowei Du (@bowei) Julian Gutierrez Oschmann (@juli4n) mind taking a look?

This is the SERVFAIL half of #246, step one of your three: the actor zone can't
answer AAAA (or any non-A qtype) at all today, which breaks musl clients on
IPv4-only clusters before dual-stack enters the picture. It makes AAAA a correct
empty answer and deliberately stops short of publishing one — the Scope
paragraph spells out why that has to wait for the router's v6 listener, and
Bowei Du (@bowei), that's the sequencing claim I'd most like checked.

Julian Gutierrez Oschmann (@juli4n), the substance is three template blocks in corefile.go and the order
between them. The fallthrough on each block carrying a match is load-bearing
in a way the plugin docs don't make obvious, so TestMakeCoreFile pins the whole
rendered zone as a golden rather than asserting substrings.

Verified against coredns/coredns:1.11.1, the pinned image, not just the
rendered file — details in the Testing section. One known gap filed as #922: the
catch-all NXDOMAINs empty non-terminals, which is latent today but wrong.

@ygao-g
Yuan Gao (ygao-g) force-pushed the atenet-dns-rcode branch 2 times, most recently from f4bc2e5 to fd6e47c Compare August 13, 2026 19:36
@bowei

Copy link
Copy Markdown
Collaborator

Yuan -- it would be good to be very specific on what we are doing in this PR. From what I can tell:

  • Add support for IPv6 AAAA for Substrate names.
  • Fix any associated things needed to get this working.

Is this what you are trying to do?

@ygao-g

Copy link
Copy Markdown
Collaborator Author

Close, but that's two PRs and this is the smaller one.

This PR doesn't publish an AAAA. It makes the zone return a correct rcode for what it doesn't answer — NODATA for a real actor name on a non-A qtype, NXDOMAIN for a name in the zone that doesn't exist. Both SERVFAIL today, on IPv4-only clusters too, which is why musl-based actors can't resolve each other at all: #888.

Publishing AAAA is #938. The three together:

#874 (this) the zone can answer a non-A qtype at all
#911 the router Service has a v6 ClusterIP and Envoy is bound on ::
#938 the zone publishes an address record per family the router has a ClusterIP in

Every actor name resolves to the same address — the router ClusterIP, with per-actor demux at Envoy on the Host header — so an AAAA for a Substrate name is those three things, and no one of them is useful alone. End state on dual-stack: an actor name resolves in both families and Envoy answers on either. Each PR carries its own verification; the real gap is that dual-stack isn't testable until #877 lands, so #911's dual-stack behaviour is argued rather than run.

On "fix any associated things" — past DNS, three more sit between a published AAAA and a usable IPv6 path, now filed as step-3 sub-tasks: #943, #944, #945.

@ygao-g
Yuan Gao (ygao-g) force-pushed the atenet-dns-rcode branch 2 times, most recently from 1634ab3 to f8b1782 Compare August 14, 2026 17:01
@ygao-g Yuan Gao (ygao-g) changed the title atenet/dns: answer non-A actor queries instead of SERVFAIL atenet/dns: actor zone returns SERVFAIL for non-A queries, breaking strict resolvers (e.g., Alpine/musl) Aug 14, 2026
@ygao-g
Yuan Gao (ygao-g) force-pushed the atenet-dns-rcode branch 6 times, most recently from 482ec1d to 9cf8384 Compare August 14, 2026 19:39
Comment thread cmd/atenet/internal/dns/corefile.go Outdated

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it possible to add test coverage to verify this change fixes the issue described in the PR?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I filed a separate PR to add scripts to manually verify the new behavior. PTAL #1038

Comment thread cmd/atenet/internal/dns/corefile_test.go Outdated
@ygao-g Yuan Gao (ygao-g) changed the title atenet/dns: actor zone returns SERVFAIL for non-A queries, breaking strict resolvers (e.g., Alpine/musl) atenet/dns: answer non-A actor queries instead of SERVFAIL Aug 18, 2026
Before, the actor zone answered A queries and failed everything else --
AAAA for a valid actor, and any name in the zone that is not an actor.
A failure reads as a temporary error rather than an answer, so clients
retry it and then give up on the name; Alpine actors could not resolve
each other at all, even on an IPv4-only cluster. After, those queries
return a correct empty answer, and one that resolvers can cache.

A unit test pins the whole rendered zone as a literal, so editing the
name pattern or the suffix fails there rather than passing silently.
Yuan Gao (ygao-g) added a commit to ygao-g/substrate that referenced this pull request Aug 18, 2026
Not intended to merge. The unit test in agent-substrate#874 pins the rendered zone but
nothing exercises CoreDNS, so this serves that zone with the pinned
coredns/coredns:1.11.1 and checks the rcode returned for A, AAAA, HTTPS,
SRV, a name in the zone that is not an actor, and a malformed one, plus
an Alpine getent for the musl path.

Pointing --corefile at a zone rendered before the fix turns the run into
a negative control: the AAAA case SERVFAILs and getent stops resolving,
while plain dig A still succeeds.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

atenet/dns: actor zone returns SERVFAIL for every query it does not answer

3 participants