mirror of
				https://github.com/coredns/coredns.git
				synced 2025-10-31 10:13:14 -04:00 
			
		
		
		
	* add upstream * add upstream * debug ci * debug ci * set context * update readme * update readme * remove empty if
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- CNAMEtarget 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
    }
}