Skip to content

Commit 2ef2e74

Browse files
[DNS] Advanced NS - network groups and wildcard records (#25094)
* Adjust network groups explanation to consider three groups * Fix wildcard behavior described for advaced nameservers * Disambiguate Cloudflare Registrar role in update-nameservers.mdx * Apply suggestions from PM review * Further clarify empty non-terminal and descendant logic * Explicitly state wildcards are supported
1 parent 27aa005 commit 2ef2e74

File tree

3 files changed

+29
-9
lines changed

3 files changed

+29
-9
lines changed

src/content/docs/dns/foundation-dns/advanced-nameservers.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,25 +19,25 @@ Also, [some behaviors are different](/dns/foundation-dns/setup/#differences-from
1919

2020
## Anycast network groups
2121

22-
To increase resiliency, advanced nameserver IPs are advertised by only one of two <GlossaryTooltip term="anycast">anycast</GlossaryTooltip> network groups.
22+
To increase resiliency, the advertisement of advanced nameserver IPs is organized into three <GlossaryTooltip term="anycast">anycast</GlossaryTooltip> network groups.
2323

24-
The two groups consist of data centers that are geographically equally distributed.
24+
Two groups consist of IPs advertised from geographically distributed data centers, and a third group consists of IPs advertised from all data centers in the Cloudflare network.
2525

2626
<Details header="United Kingdom example">
2727

2828
| IPs | Group | Data centers |
2929
| --------------- | ----- | -------------------- |
3030
| `108.162.198.1` | A | London and Edinburgh |
3131
| `172.64.40.1` | B | Manchester |
32-
| `162.159.60.1` | A | London and Edinburgh |
32+
| `162.159.60.1` | C | Manchester, London, and Edinburgh |
3333

3434
</Details>
3535

3636
In DNS resolution, a resolver eventually acquires a list of all IPs where authoritative nameservers for a domain can be reached, and will then usually prefer the IP with the best resolution performance.
3737

38-
When, instead of advertising all IPs in all data centers, this group logic is applied, resiliency is improved because, if one of the data centers experiences a localized issue, the resolver can fall back to an IP advertised by the next closest data center.
38+
When, instead of advertising all IPs in all data centers, this group logic is applied, resiliency is improved because, if one of the data centers experiences a localized issue, the resolver can fall back to an IP advertised by the next closest data center. The third group adds another layer of redundancy, further enhancing resiliency.
3939

40-
Refer to [our blog post](https://blog.cloudflare.com/foundation-dns-launch) for an in-depth explanation.
40+
Refer to [our blog post](https://blog.cloudflare.com/foundation-dns-launch) for an in-depth explanation of the distributed groups logic.
4141

4242
## Dedicated release process
4343

src/content/docs/dns/foundation-dns/setup.mdx

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,25 @@ Before opting in for advanced nameservers, consider the following:
2727

2828
Some behaviors are different from standard Cloudflare nameservers:
2929

30-
- Wildcard records: if moving from standard Cloudflare nameservers to Foundation DNS advanced nameservers, make sure to explicitly create records for subdomains currently covered by wildcard records (`*.example.com`).
30+
- Wildcard records are still supported but, with advanced nameservers, a wildcard record (`*.example.com`) will not apply to a subdomain that is an empty non-terminal. An empty non-terminal is a node in the DNS tree that has no records associated with it but has descendants that do, as exemplified below.
31+
32+
<Details header="Example">
33+
34+
<Example>
35+
36+
DNS management for **example.com**
37+
38+
| **Type** | **Name** | **Content** |
39+
| -------- | -------- | ------------------------- |
40+
| A | * | `192.0.2.1` |
41+
| A | a.b | `192.0.2.5` |
42+
43+
</Example>
44+
45+
In this example, `a.b.example.com` is a descendant of `b.example.com`, and `b.example.com` is an empty non-terminal. This means that the wildcard `*.example.com` will not apply to `b.example.com`.
46+
47+
</Details>
48+
3149
- Subdomain delegation: once a subdomain is delegated via NS records, Cloudflare will not serve any other records (such as A, TXT, or CNAME) on that subdomain from the parent zone, even if those records exist.
3250

3351
<Details header="Example">
@@ -84,4 +102,4 @@ To enable advanced nameservers on an existing zone:
84102
:::caution
85103

86104
Make sure the values for your assigned nameservers are copied exactly.
87-
:::
105+
:::

src/content/docs/dns/nameservers/update-nameservers.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,11 @@ To use Cloudflare DNS as an authoritative DNS provider - be it in a [primary (fu
1111

1212
## Specific processes
1313

14-
Although Cloudflare will [provide you the nameservers](/dns/nameservers/#authoritative-nameservers-offering) or allow you to create your own [custom nameservers](/dns/nameservers/custom-nameservers/), the final step to make Cloudflare an authoritative DNS provider for your domain may have to be done outside of Cloudflare.
14+
Although Cloudflare will [provide you the nameservers](/dns/nameservers/#authoritative-nameservers-offering) or allow you to create your own [custom nameservers](/dns/nameservers/custom-nameservers/), the final step to make Cloudflare an authoritative DNS provider for your domain may have to be done outside of Cloudflare. If you are not using [Cloudflare Registrar](/registrar/), consider which of the following sections correspond to your use case.
1515

16-
Unless you are using [Cloudflare Registrar](/registrar/), consider which of the following sections correspond to your use case.
16+
:::note[Custom or advanced nameservers]
17+
If you are using Cloudflare Registrar with [custom nameservers](/dns/nameservers/custom-nameservers/) or [advanced nameservers](/dns/foundation-dns/setup/), note that you must [reach out to support](/support/contacting-cloudflare-support/) to have the nameservers updated accordingly.
18+
:::
1719

1820
### Your domain uses a different registrar
1921

0 commit comments

Comments
 (0)