Skip to content

Commit 353cc94

Browse files
authored
feat: FAQ for dns-delegated gbl deployment (#710)
1 parent 924941d commit 353cc94

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/layers/network/faq.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,16 @@ domains are configured with CNAME (or apex alias) records to point to service do
9595

9696
The architecture does not support other configurations, or non-standard component names.
9797

98+
## Why should the `dns-delegated` component be deployed globally rather than regionally?
99+
100+
The `dns-delegated` component is designed to manage resources across all regions within an AWS account, such as with Route 53 DNS records. Deploying it at the regional level can lead to conflicts because it implies multiple deployments per account, which would cause Terraform to fight for control over the same resources.
101+
102+
Although the `gbl` (“global”) region is not a real AWS region, it is used as a placeholder to signify that resources are meant to be managed globally, not regionally. Deploying `dns-delegated` globally ensures there is a single source of truth for these DNS records within the account.
103+
104+
Deploying this component regionally can cause issues, especially if multiple regional stacks try to manage the same DNS records. This creates an anti-pattern where resources meant to be global are unintentionally duplicated, leading to configuration drift and unexpected behavior.
105+
106+
Please see the [global (default) region](/learn/conventions/#global-default-region) definition for more on `gbl` as a convention.
107+
98108
## How is the EKS network configured?
99109

100110
EKS network is designed with this network and DNS architecture in mind, but is another complex topic. For more, see the

0 commit comments

Comments
 (0)