History

Chris O'Haver 6beeabc47c plugin/federation: Add upstream option to federation (#2177 ) * add upstream * add upstream * debug ci * debug ci * set context * update readme * update readme * remove empty if		2018-10-15 12:43:03 -04:00
..
federation.go	plugin/federation: Add upstream option to federation (#2177 )	2018-10-15 12:43:03 -04:00
federation_test.go	plugin/federation: handle missing avail-zone/region labels better (#2092 )	2018-09-12 07:07:24 +01:00
kubernetes_api_test.go	Revert "use keys (#2167 )" (#2188 )	2018-10-11 16:59:50 -04:00
log_test.go	Clean up tests logging (#1979 )	2018-07-19 16:23:06 +01:00
OWNERS	Add OWNERS file (#1486 )	2018-02-08 10:55:51 +00:00
README.md	plugin/federation: Add upstream option to federation (#2177 )	2018-10-15 12:43:03 -04:00
setup.go	plugin/federation: Add upstream option to federation (#2177 )	2018-10-15 12:43:03 -04:00
setup_test.go	Remove the word middleware (#1067 )	2017-09-14 09:36:06 +01:00

README.md

federation

Name

federation - enables federated queries to be resolved via the kubernetes plugin.

Description

Enabling this plugin allows Federated queries to be resolved via the kubernetes plugin.

Enabling federation without also having kubernetes is a noop.

Syntax

federation [ZONES...] {
    NAME DOMAIN
    upstream [ADDRESS...]
}

Each NAME and DOMAIN defines federation membership. One entry for each. A duplicate NAME will silently overwrite any previous value.
upstream [ADDRESS...] defines the upstream resolvers used for resolving the CNAME target produced by this plugin. If no ADDRESS is given, CoreDNS will resolve External Services against itself. ADDRESS can be an IP, an IP:port, or a path to a file structured like resolv.conf.

Examples

Here we handle all service requests in the prod and stage federations.

. {
    kubernetes cluster.local
    federation cluster.local {
        prod prod.feddomain.com
        staging staging.feddomain.com
        upstream
    }
}

Or slightly shorter:

cluster.local {
    kubernetes
    federation {
        prod prod.feddomain.com
        staging staging.feddomain.com
        upstream
    }
}