Skip to content

Commit 8eac597

Browse files
Expand architecture overview with detailed examples
1 parent 3edc4f9 commit 8eac597

File tree

1 file changed

+45
-3
lines changed

1 file changed

+45
-3
lines changed

src/content/docs/dns/internal-dns/index.mdx

Lines changed: 45 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ head:
1313
content: Internal DNS
1414
---
1515

16-
import { Render, Description, Plan, RelatedProduct, DirectoryListing, GlossaryTooltip } from "~/components";
16+
import { Render, Description, Plan, RelatedProduct, DirectoryListing, GlossaryTooltip, Example } from "~/components";
1717

1818
<Description>
1919
Simplify private network management with Cloudflare DNS for your internal resources.
@@ -27,7 +27,7 @@ Manage DNS records that should only be accessible within your private network. I
2727

2828
## Architecture overview
2929

30-
Internal DNS queries can only be resolved via the Cloudflare Gateway resolver, which acts as an interface between the DNS client and Internal DNS zones.
30+
Internal DNS queries can only be resolved via the Cloudflare Gateway resolver, which acts as an interface between the DNS client and internal DNS zones.
3131

3232
To connect to Cloudflare, you can use [WARP](/cloudflare-one/connections/connect-devices/warp/), any of the DNS endpoints supported with [DNS locations](/cloudflare-one/connections/connect-devices/agentless/dns/locations/), or [Magic WAN on-ramps](/magic-wan/on-ramps/).
3333

@@ -56,7 +56,49 @@ flowchart LR
5656
C --Query--> Y
5757
```
5858

59-
Each DNS view is a logical grouping of internal DNS zones. Internal DNS zones can either contain the <GlossaryTooltip term="DNS record" link="/dns/manage-dns-records/">DNS records</ GlossaryTooltip> that should be used to resolve an internal DNS query or reference another internal zone that contains such records.
59+
Each DNS view is a logical grouping of internal DNS zones.
60+
61+
```mermaid
62+
flowchart LR
63+
accTitle: Internal DNS views and zones
64+
accDescr: Diagram exemplifying Internal DNS views and zones relationship
65+
subgraph Internal DNS
66+
subgraph View 111 - London
67+
Y[example.local <br /> Zone 200]
68+
Z[local <br /> Zone 201]
69+
end
70+
subgraph View 110 - San Francisco
71+
X[example.com <br /> Zone 301]
72+
B[example.local <br /> Zone 300]
73+
S[com <br /> Zone 302]
74+
end
75+
W[net <br /> Zone 501]
76+
end
77+
```
78+
79+
Internal DNS zones contain the <GlossaryTooltip term="DNS record" link="/dns/manage-dns-records/">DNS records</ GlossaryTooltip> that should be used to resolve an internal DNS query. Also, if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is [referencing another internal zone](/dns/internal-dns/internal-zones/#reference-zones).
80+
81+
<Example>
82+
83+
```mermaid
84+
flowchart LR
85+
accTitle: Internal DNS zones and internal records
86+
accDescr: Diagram exemplifying Internal DNS zones and records relationship
87+
subgraph View 111 - London
88+
subgraph Zone 201 - local
89+
S[@ A 192.0.2.10]
90+
T[ghi.example A 192.0.2.15]
91+
end
92+
subgraph Zone 200 - example.local
93+
X[@ A 192.0.2.1]
94+
Y[abc A 192.0.2.6]
95+
Z[def A 192.0.2.9]
96+
end
97+
end
98+
```
99+
In this example, a query for `ghi.example.local` routed to view ID 111 would go to zone 200, which presents the longest matching zone name (`example.local`). Zone 200 does not contain a record for `ghi` but, if it is referencing zone 201, Cloudflare will then look for the queried record within the reference zone.
100+
101+
</Example>
60102

61103
## Resources
62104

0 commit comments

Comments
 (0)