From 0cfe43f59464c186a65ffd7fad1f56cc7c33316c Mon Sep 17 00:00:00 2001 From: Kyle Havlovitz Date: Tue, 21 Jun 2022 11:33:13 -0700 Subject: [PATCH] docs: Clarify section on partitioned node DNS lookups --- website/content/docs/discovery/dns.mdx | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/website/content/docs/discovery/dns.mdx b/website/content/docs/discovery/dns.mdx index 8a542b4ef2..17c25e6e61 100644 --- a/website/content/docs/discovery/dns.mdx +++ b/website/content/docs/discovery/dns.mdx @@ -469,7 +469,9 @@ options. ## Namespaced/Partitioned Services and Nodes -Consul Enterprise supports resolving namespaced and partitioned services and nodes via DNS. +Consul Enterprise supports resolving namespaced and partitioned services via DNS. +The DNS server in Consul Enterprise can resolve services assigned to namespaces and partitions. +The DNS server can also resolve nodes assigned to partitions. To maintain backwards compatibility existing queries can be used and these will resolve services within the `default` namespace and partition. However, for resolving services from other namespaces or partitions the following form can be used: @@ -478,12 +480,18 @@ services from other namespaces or partitions the following form can be used: [tag.].service..ns..ap..dc. ``` -This is the canonical name of a Consul Enterprise service. Currently at least 2 of -`[namespace, partition, datacenter]` must be present - in a future version (once the -[`prefer_namespace` configuration](/docs/agent/config/config-files#dns_prefer_namespace) has been -deprecated), the namespace, partition and datacenter components will all become optional -and may be individually omitted to default to the `default` namespace, local partition -or local datacenter respectively. +This sequence is the canonical naming convention of a Consul Enterprise service. At least two of the following +fields must be present: +* `namespace` +* `partition` +* `datacenter` + +For node lookups, only the partition and datacenter need to be specified as nodes cannot be +namespaced. + +```text +[tag.].service..ap..dc. +``` For node lookups, only the partition and datacenter need to be specified (nodes cannot be namespaced):