website: adding tag/service name dns compliance docs

This commit is contained in:
Ryan Uber 2015-06-25 09:07:55 -07:00
parent ba5c3a4c81
commit 6290cb93bd
1 changed files with 13 additions and 0 deletions

View File

@ -123,3 +123,16 @@ Multiple services definitions can be provided at once using the `services`
] ]
} }
``` ```
## Service and Tag Names with DNS
Consul exposes service definitions and tags over the [DNS](/docs/agent/dns.html)
interface. DNS queries have a strict set of allowed characters and a
well-defined format that Consul cannot override. While it is possible to
register services or tags with names that don't match the conventions, those
services and tags will not be discoverable via the DNS interface. It is
recommended to always use DNS-compliant service and tag names.
DNS-compliant service and tag names may contain any alpha-numeric characters, as
well as dashes. Dots are not supported because Consul internally uses them to
delimit service tags.