coredns/middleware/autopath
Miek Gieben ea77f2a2ca core: replace GetMiddleware (#885)
* core: replace GetMiddleware

See the discussion in #881. GetMiddleware would add a `nil` middleware
to the callstack thereby breaking functionality.

This PR drops it in favor of RegisterHandler which is a completely
standalone registry for middleware that want to let it self know to
other middleware.

Currenly *autopath* uses this to call *kubernetes*'s AutoPath method
for dynamic autopathing.

* Drop GetMiddleware

* Register metrics

* drop the panic
2017-08-10 21:31:36 +01:00
..
autopath.go middleware/autopath: some fixes (#883) 2017-08-10 19:27:54 +01:00
autopath_test.go middleware/autopath: some fixes (#883) 2017-08-10 19:27:54 +01:00
cname.go WIP: autopath as middleware (#859) 2017-08-09 03:13:38 -07:00
nonwriter.go WIP: autopath as middleware (#859) 2017-08-09 03:13:38 -07:00
README.md WIP: autopath as middleware (#859) 2017-08-09 03:13:38 -07:00
setup.go core: replace GetMiddleware (#885) 2017-08-10 21:31:36 +01:00
setup_test.go Some go vet cleanup (#869) 2017-08-09 11:00:03 -07:00

autopath

The autopath middleware allows CoreDNS to perform 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 middleware. For instance @kubernetes, will call out to the kubernetes middleware (for each query) to retrieve the search list it should use.

Currently the following set of middleware has implemented autopath:

  • kubernetes

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 middleware.