luxolus
/
open-consul
2
0
Fork 0
Code Issues 1 Pull Requests Packages Releases Wiki Activity

More heavy-handed reorg of content for flow.

This commit is contained in:
Ryan Breen 2015-01-31 13:07:21 -05:00
parent 01e2895573
commit 7396677907
1 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
website/source/docs/agent/dns.html.markdown
View File

@ -15,15 +15,15 @@ discovery without any high-touch integration with Consul.
For example, instead of making HTTP API requests to Consul,
a host can use the DNS server directly via name lookups
like "redis.service.east-aws.consul". This query automatically
translates to a lookup of nodes that provide the redis service
are located in the "east-aws" datacenter and have no failing health checks.
translates to a lookup of nodes that provide the redis service,
are located in the "east-aws" datacenter, and have no failing health checks.
It's that simple!
There are a number of [configuration options](/docs/agent/options.html) that
are important for the DNS interface. They are `client_addr`, `ports.dns`, `recursors`,
`domain`, and `dns_config`. By default, Consul will listen on 127.0.0.1:8600 for DNS queries
in the "consul." domain, without support for DNS recursion. All queries are case-insensitive,
so a lookup of `PostgreSQL.node.dc1.consul` will find all nodes named `postgresql`.
There are a number of configuration options that are important for the DNS interface,
specifically `client_addr`, `ports.dns`, `recursors`, `domain`, and `dns_config`. By default,
Consul will listen on 127.0.0.1:8600 for DNS queries in the "consul." domain, without support
for further DNS recursion. Please consult the [documentation on configuration options](/docs/agent/options.html)
for more details.
There are a few ways to use the DNS interface. One option is to use a custom
DNS resolver library and point it at Consul. Another option is to set Consul
@ -35,6 +35,9 @@ You can experiment with Consul's DNS server on the command line using tools such
$ dig @127.0.0.1 -p 8600 redis.service.dc1.consul. ANY
Note that in DNS, all queries are case-insensitive. A lookup of `PostgreSQL.node.dc1.consul`
will find all nodes named `postgresql`.
## Node Lookups
To resolve names, Consul relies on a very specific format for queries.