autopath

README

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
• erratic

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.

Bugs

When the cache middleware is enabled it is possible for pods in different namespaces to get the same answer.

Documentation

Overview

Package autopath implements autopathing. This is a hack; it shortcuts the client's search path resolution by performing these lookups on the server...

The server has a copy (via AutoPathFunc) of the client's search path and on receiving a query it first establish if the suffix matches the FIRST configured element. If no match can be found the query will be forwarded up the middleware chain without interference (iff 'fallthrough' has been set).

If the query is deemed to fall in the search path the server will perform the queries with each element of the search path appended in sequence until a non-NXDOMAIN answer has been found. That reply will then be returned to the client - with some CNAME hackery to let the client accept the reply.

If all queries return NXDOMAIN we return the original as-is and let the client continue searching. The client will go to the next element in the search path, but we won’t do any more autopathing. It means that in the failure case, you do more work, since the server looks it up, then the client still needs to go through the search path.

It is assume the search path ordering is identical between server and client.

Midldeware implementing autopath, must have a function called `AutoPath` of type autopath.Func. Note the searchpath must be ending with the empty string.

I.e:

func (m Middleware ) AutoPath(state request.Request) []string {
	return []string{"first", "second", "last", ""}
}

Index

• type AutoPath
  • func (a *AutoPath) Name() string
  • func (a *AutoPath) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)
• type Func

Types

type AutoPath

type AutoPath struct {
	Next  middleware.Handler
	Zones []string
	// contains filtered or unexported fields
}

AutoPath perform autopath: service side search path completion.

func (*AutoPath) Name

func (a *AutoPath) Name() string

Name implements the Handler interface.

func (*AutoPath) ServeDNS

func (a *AutoPath) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the middleware.Handle interface.

type Func

type Func func(request.Request) []string

Func defines the function middleware should implement to return a search path to the autopath middleware. The last element of the slice must be the empty string. If Func returns a nil slice, no autopathing will be done.