coredns/plugin/autopath
James Hartig a469a17cdf Instead of hardcoding plugin lists in autopath/health, use interfaces. (#1306)
Switched health and autopath plugin to allow any plugins to be used instead
of a hardcoded list. I did not switch federation over since it wasn't
obvious that anything other than kubernetes could be used with it.

Fixes #1291
2017-12-12 20:40:30 +00:00
..
autopath.go Instead of hardcoding plugin lists in autopath/health, use interfaces. (#1306) 2017-12-12 20:40:30 +00:00
autopath_test.go pkg: add dnstest (#1098) 2017-09-21 15:15:47 +01:00
cname.go Remove the word middleware (#1067) 2017-09-14 09:36:06 +01:00
metrics.go plugin/autopath: Add metrics and remove log line (#1143) 2017-10-15 19:39:24 +02:00
README.md Instead of hardcoding plugin lists in autopath/health, use interfaces. (#1306) 2017-12-12 20:40:30 +00:00
setup.go Instead of hardcoding plugin lists in autopath/health, use interfaces. (#1306) 2017-12-12 20:40:30 +00:00
setup_test.go More Middleware -> Plugin conversions (#1088) 2017-09-16 14:13:28 +01:00

autopath

autopath allows for server side search path completion.

If it sees a query that matches the first element of the configured search path, autopath will follow the chain of search path elements and returns the first reply that is not NXDOMAIN. On any failures the original reply is returned. Because autopath returns a reply for a name that wasn't the original question it will add a CNAME that points from the original name (with the search path element in it) to the name of this answer.

Syntax

autopath [ZONE...] RESOLV-CONF
  • ZONES zones autopath should be authoritative for.
  • RESOLV-CONF points to a resolv.conf like file or uses a special syntax to point to another plugin. For instance @kubernetes, will call out to the kubernetes plugin (for each query) to retrieve the search list it should use.

If a plugin implements the AutoPather interface then it can be used.

Metrics

If monitoring is enabled (via the prometheus directive) then the following metric is exported:

  • coredns_autopath_success_count_total{} - counter of successfully autopath-ed queries.

Examples

autopath my-resolv.conf

Use my-resolv.conf as the file to get the search path from. This file only needs so have one line: search domain1 domain2 ...

autopath @kubernetes

Use the search path dynamically retrieved from the kubernetes plugin.